Set Data Retrieval Policy (PUT policy) - Amazon S3 Glacier

Se você é novato no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes de armazenamento para arquivamento de objetos no Guia do usuário do Amazon S3.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Set Data Retrieval Policy (PUT policy)

Descrição

Esta operação define e impõe uma política de recuperação de dados na região da AWS especificada na solicitação PUT. Você pode definir uma política por região da AWS para uma Conta da AWS. A política é imposta após alguns minutos de uma operação PUT bem-sucedida.

A operação set policy não afeta trabalhos de recuperação que estavam em andamento antes da imposição da política. Para obter mais informações sobre políticas de recuperação de dados, consulte Políticas de recuperação de dados do S3 Glacier.

Solicitações

Sintaxe

Para definir uma política de recuperação de dados, envie uma solicitação HTTP PUT para o URI da política de recuperação de dados conforme mostrado no exemplo de sintaxe a seguir.

PUT /AccountId/policies/data-retrieval HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue Content-Length: Length x-amz-glacier-version: 2012-06-01 { "Policy": { "Rules":[ { "Strategy": String, "BytesPerHour": Number } ] } }

nota

O valor de AccountId é o ID de Conta da AWS. Esse valor deve corresponder ao ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Você pode especificar um ID de Conta da AWS ou, de forma opcional, um '-' (hífen) único; nesse caso, o Amazon S3 Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua nenhum hífen ('-') no ID.

Parâmetros de solicitação

Essa operação não usa parâmetros de solicitação.

Cabeçalhos de solicitação

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação comuns.

Corpo da solicitação

O corpo da solicitação contém os campos JSON a seguir.

BytesPerHour

O número máximo de bytes que podem ser recuperados em uma hora.

Este campo somente será obrigatório se o valor do campo Strategy for BytesPerHour. A operação PUT será rejeitada se o campo Strategy não for definido como BytesPerHour e você definir esse campo.

Tipo: número

Obrigatório: sim, se o campo Strategy for definido como BytesPerHour. Do contrário, não.

Valores válidos: valor do inteiro mínimo de 1. Valor do inteiro máximo de 2^63 - 1 inclusive.

Regras

A regra da política. Embora esse seja um tipo de lista, atualmente deve haver somente uma regra, que contém um campo Strategy e, como opção, um campo BytesPerHour.

Tipo: matriz

Obrigatório: Sim

Strategy

O tipo de política de recuperação de dados a ser definido.

Tipo: string

Obrigatório: Sim

Valores válidos: BytesPerHour|FreeTier|None. BytesPerHour é equivalente a selecionar Max Retrieval Rate (Taxa de recuperação máxima) no console. FreeTier é equivalente a selecionar Somente nível gratuito no console. None é equivalente a selecionar No Retrieval Policy (Nenhuma política de recuperação) no console. Para obter mais informações sobre como selecionar políticas de recuperação de dados no console, consulte Políticas de recuperação de dados do S3 Glacier.

Respostas

Sintaxe

HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date

Cabeçalhos de resposta

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte Cabeçalhos de resposta comuns.

Corpo da resposta

Essa operação não retorna um corpo de resposta.

Erros

Para obter informações sobre exceções e mensagens de erro do Amazon S3 Glacier, consulte Respostas de erro.

Exemplos

Exemplo de solicitação

O exemplo a seguir envia uma solicitação HTTP PUT com o campo Strategy definido como BytesPerHour.

PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] } }

O exemplo a seguir envia uma solicitação HTTP PUT com o campo Strategy definido como FreeTier.

PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"FreeTier" } ] } }

O exemplo a seguir envia uma solicitação HTTP PUT com o campo Strategy definido como None.

PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"None" } ] } }

Exemplo de resposta

Se a solicitação for bem-sucedida, o Amazon S3 Glacier (S3 Glacier) define a política e retorna uma resposta HTTP 204 No Content, conforme mostrado no exemplo a seguir.

HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT