View a markdown version of this page

GET Bucket lifecycle (obsoleto) - Amazon Simple Storage Service
DescriçãoSolicitaçõesRespostasErros especiaisExemplosRecursos relacionados

GET Bucket lifecycle (obsoleto)

Descrição

Importante

Para obter uma versão atualizada dessa API, consulte GetBucketLifecycleConfiguration. Se você tiver configurado um ciclo de vida de bucket usando o elemento <filter>, deverá ver uma versão atualizada desse tópico. Esse tópico é fornecido para compatibilidade com versões anteriores.

Retorna as informações da configuração de lifecycle definida no bucket. Para obter informações sobre configuração de ciclo de vida, consulte Gerenciamento do ciclo de vida de objetos no Guia do usuário do Amazon Simple Storage Service.

Para usar essa operação, você deve ter a permissão para executar a ação s3:GetLifecycleConfiguration. Por padrão, o proprietário do bucket tem essa permissão. Ele pode conceder essa permissão a outros. Para obter mais informações sobre permissões, consulte Gerenciamento de permissões de acesso a seus recursos do Amazon S3 no Guia do desenvolvedor do Amazon Simple Storage Service.

Solicitações

Sintaxe

GET /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Date: date
Authorization: authorization string (see Autenticação de solicitações (AWS Signature Version 4))

Parâmetros da solicitação

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

Cabeçalhos de solicitação

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

Elementos da solicitação

Essa implementação da operação não usa elementos de solicitação.

Respostas

Cabeçalhos de resposta

Essa implementação da operação usa somente os cabeçalhos de resposta que são comuns à maioria das respostas. Para obter mais informações, consulte Cabeçalhos de resposta comuns.

Elementos de resposta

Essa implementação de GET retorna os seguintes elementos de resposta.

Name (Nome) Descrição Obrigatório
AbortIncompleteMultipartUpload Contêiner para especificar quando um upload fragmentado incompleto se torna elegível para uma operação de interrupção.

Secundário: DaysAfterInitiation

Tipo: Container

Antepassado: Rule

 Sim, se nenhuma outra ação for especificada para a regra
Date

Data em que deseja que o Amazon S3 realize a ação. Para obter mais informações, consulte Regras de ciclo de vida: com base em uma data específica no Guia do usuário do Amazon Simple Storage Service.

O valor de data deve estar em conformidade com o formato ISO 8601. A hora é sempre meia-noite (UTC).

Tipo: string

Antepassado: Expiration ou Transition

 Sim, se Days e ExpiredObjectDeleteMarker estiverem ausentes
Days

Especifica o número de dias após a criação de objeto quando a ação de regra específica entra em vigor. O tempo de elegibilidade do objeto é calculado como a hora de criação + o número de dias com a hora resultante arredondada para a meia-noite UTC do dia seguinte.

Tipo: inteiro não negativo quando usado com Transition, inteiro positivo quando usado com Expiration.

Antepassado: Transition ou Expiration

 Sim, se Date e ExpiredObjectDeleteMarker estiverem ausentes
DaysAfterInitiation

Especifica o número de dias quando o upload fragmentado deve ser concluído depois de iniciado. Se não for concluído no número especificado de dias, ele se tornará elegível para uma operação de interrupção e o Amazon S3 cancelará o upload fragmentado incompleto.

Tipo: número inteiro positivo

Antepassado: AbortIncompleteMultipartUpload

 Sim, se Date estiver ausente
Expiration

Essa ação especifica um período na vida útil do objeto em que o Amazon S3 deve realizar a ação de expiração apropriada. A ação de expiração ocorre somente em objetos elegíveis de acordo com o período especificado no elemento filho Date ou Days. A ação realizada pelo Amazon S3 depende de se o bucket está habilitado para versionamento.

  • Se o versionamento nunca tiver sido habilitado no bucket, o Amazon S3 excluirá permanentemente a única cópia do objeto.

  • Caso contrário, se o bucket tiver o versionamento habilitado (ou o versionamento estiver suspenso), a ação se aplicará somente à versão atual do objeto. Os buckets com versionamento habilitado ou suspenso podem ter várias versões do mesmo objeto: uma versão atual e nenhuma ou mais versões desatualizadas.

    Em vez de excluir a versão atual, o Amazon S3 a transforma em uma versão desatualizada, adicionando um marcador de exclusão como a nova versão atual.

    Importante

    Se algum bucket tiver o versionamento suspenso, o Amazon S3 criará um marcador de exclusão com ID de versão null. Se você tiver uma versão com ID null, o Amazon S3 substituirá essa versão.

    nota

    Para definir a expiração para objetos desatualizados, você deve usar a ação NoncurrentVersionExpiration.

Tipo: Container

Filhos: Days ou Date

Antepassado: Rule

 Sim, se a tag principal for especificada
ID

Identificador exclusivo da regra. O valor não pode ser maior que 255 caracteres.

Tipo: string

Antepassado: Rule

 Não
LifecycleConfiguration

Contêiner para regras de ciclo de vida. Você pode adicionar até 1.000 regras.

Tipo: Container

Filhos: Rule

Ancestral: Nenhum

 Sim
ExpiredObjectDeleteMarker

Em um bucket com versões (versionamento ativado ou suspenso no bucket), esse elemento indica se o Amazon S3 excluirá os marcadores de exclusão de objetos expirados no bucket. Por exemplo, acesse Exemplo 8: especificar a ação de expiração para remover marcadores de exclusão de objetos expirados no Guia do usuário do Amazon Simple Storage Service.

Tipo: string

Valores válidos: true | false (o valor false é permitido, mas não está funcionando; o Amazon S3 não vai agir se o valor for false)

Antepassado: Expiration

 Sim, se Date e Days estiverem ausentes
NoncurrentDays

Especifica o número de dias que um objeto precisa estar desatualizado antes do Amazon S3 poder executar a ação associada. Para obter informações sobre o cálculo de dias com desatualização, consulte Regras de ciclo de vida com base no número de dias no Guia do usuário do Amazon Simple Storage Service.

Tipo: inteiro não negativo quando usado com NoncurrentVersionTransition, inteiro positivo quando usado com NoncurrentVersionExpiration

Antepassado: NoncurrentVersionExpiration ou NoncurrentVersionTransition

 Sim, somente se o antepassado estiver presente
NoncurrentVersionExpiration

Especifica quando expiram as versões de objetos não atuais. Após a expiração, o Amazon S3 exclui permanentemente as versões de objetos não atuais.

Defina essa ação de configuração de ciclo de vida em um bucket que tenha versionamento habilitado (ou suspenso), para solicitar que o Amazon S3 exclua versões de objetos desatualizadas em um período específico na vida útil do objeto.

Tipo: Container

Filhos: NoncurrentDays

Antepassado: Rule

 Sim, se nenhuma outra ação estiver presente na Rule
NoncurrentVersionTransition

Contêiner para a regra de transição que descreve quando objetos desatualizados fazem a transição para STANDARD_IA, ONEZONE_IA ou a classe de armazenamento.

Se o bucket estiver habilitado para versionamento (ou o versionamento estiver suspenso), você poderá definir essa ação para solicitar que o Amazon S3 realize a transição de versões de objetos desatualizadas para a classe de armazenamento em um período específico na vida útil do objeto.

Tipo: Container

Filhos: NoncurrentDays e StorageClass

Antepassado: Rule

 Sim, se nenhuma outra ação estiver presente na Rule
Prefix

Prefixo de chave de objeto que identifica um ou mais objetos aos quais a regra se aplica.

Tipo: string

Antepassado: Rule

 Sim
Rule

Contêiner para uma regra de ciclo de vida.

Tipo: Container

Antepassado: LifecycleConfiguration

 Sim
Status

Se habilitado, o Amazon S3 vai executar a regra conforme programado. Se desabilitado, o Amazon S3 vai ignorar a regra.

Tipo: string

Antepassado: Rule

Valores válidos: Enabled ou Disabled

 Sim
StorageClass

Especifica a classe de armazenamento do Amazon S3 para a qual o objeto fará a transição.

Tipo: string

Antepassado: Transition e NoncurrentVersionTransition

Valores válidos: STANDARD_IA | ONEZONE_IA |

Sim
Transition

Essa ação especifica um período na vida útil dos objetos em que o Amazon S3 deve fazer a transição deles para STANDARD_IA, ONEZONE_IA ou a classe de armazenamento. Quando essa ação está em vigor, o que o Amazon S3 faz depende se o bucket está habilitado para versionamento.

  • Se o versionamento nunca tiver sido habilitado no bucket, o Amazon S3 fará a transição da única cópia do objeto para a classe de armazenamento especificada.

  • Quando o bucket está habilitado para versionamento (ou o versionamento está suspenso), o Amazon S3 faz a transição somente das versões atuais dos objetos identificados na regra.

    nota

    Um bucket com versionamento habilitado ou suspenso pode conter várias versões de um objeto. Essa ação não tem efeito em versões de objeto desatualizadas. Para fazer a transição de objetos desatualizados, use a ação NoncurrentVersionTransition.

Tipo: Container

Filhos: Days ou Date e StorageClass

Antepassado: Rule

 Sim, se nenhuma outra ação estiver presente na Rule

Erros especiais

Código de erro Descrição Código de status HTTP Prefixo do código de falha SOAP
NoSuchLifecycleConfiguration A configuração de ciclo de vida não existe. 404 Not Found (404 Não encontrado) Cliente

Para obter informações gerais sobre erros do Amazon S3 e uma lista de códigos de erro, consulte Respostas de erro.

Exemplos

Exemplo 1: recuperar um sub-recurso do ciclo de vida

Esse exemplo é uma solicitação GET para recuperar o sub-recurso lifecycle do bucket especificado e um exemplo de resposta com a configuração de ciclo de vida retornada.

Exemplo de solicitação

GET /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com
x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT
Authorization: signatureValue

Resposta da amostra

HTTP/1.1 200 OK
x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
x-amz-request-id: 51991C342C575321
Date: Thu, 15 Nov 2012 00:17:23 GMT
Server: AmazonS3
Content-Length: 358

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Rule>
        <ID>Archive and then delete rule</ID>
        <Prefix>projectdocs/</Prefix>
        <Status>Enabled</Status>
       <Transition>
           <Days>30</Days>
           <StorageClass>STANDARD_IA</StorageClass>
        </Transition>
        <Transition>
           <Days>365</Days>
           <StorageClass>GLACIER</StorageClass>
        </Transition>
        <Expiration>
           <Days>3650</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>