# GET Bucket lifecycle (obsoleto)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

## Descrição
<a name="v1-rel-RESTBucketGETlifecycle_Description"></a>



 

**Importante**  
Para obter uma versão atualizada dessa API, consulte [GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html). 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) no *Guia do desenvolvedor do Amazon Simple Storage Service*.

## Solicitações
<a name="v1-rel-RESTBucketGETlifecycle-requests"></a>

### Sintaxe
<a name="v1-rel-RESTBucketGETlifecycle-requests-syntax"></a>

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

### Parâmetros da solicitação
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

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

### Cabeçalhos de solicitação
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

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](RESTCommonRequestHeaders.md).

### Elementos da solicitação
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

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

## Respostas
<a name="v1-rel-RESTBucketGETlifecycle-responses"></a>

### Cabeçalhos de resposta
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

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](RESTCommonResponseHeaders.md).

### Elementos de resposta
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-elements"></a>

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`<br />Tipo: Container<br />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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date) no *Guia do usuário do Amazon Simple Storage Service*.<br />O valor de data deve estar em conformidade com o formato ISO 8601. A hora é sempre meia-noite (UTC). <br />Tipo: string<br />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.<br />Tipo: inteiro não negativo quando usado com `Transition`, inteiro positivo quando usado com `Expiration`.<br />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.<br />Tipo: número inteiro positivo<br />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. <br /> +  Se o versionamento nunca tiver sido habilitado no bucket, o Amazon S3 excluirá permanentemente a única cópia do objeto.  <br />+  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. <br />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.  <br />  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.   <br />  Para definir a expiração para objetos desatualizados, você deve usar a ação `NoncurrentVersionExpiration`.  <br />Tipo: Container<br />Filhos: Days ou Date<br />Antepassado: Rule | Sim, se a tag principal for especificada | 
|  ID  | Identificador exclusivo da regra. O valor não pode ser maior que 255 caracteres.<br />Tipo: string<br />Antepassado: Rule | Não | 
| LifecycleConfiguration  | Contêiner para regras de ciclo de vida. Você pode adicionar até 1.000 regras.<br />Tipo: Container<br />Filhos: Rule<br />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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8) no *Guia do usuário do Amazon Simple Storage Service*.<br />Tipo: string <br />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)<br />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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days) no *Guia do usuário do Amazon Simple Storage Service*.<br />Tipo: inteiro não negativo quando usado com `NoncurrentVersionTransition`, inteiro positivo quando usado com `NoncurrentVersionExpiration`<br />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. <br />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.<br />Tipo: Container<br />Filhos: NoncurrentDays <br />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. <br />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.<br />Tipo: Container<br />Filhos: NoncurrentDays e StorageClass<br />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.<br />Tipo: string<br />Antepassado: Rule | Sim | 
| Rule  | Contêiner para uma regra de ciclo de vida.<br />Tipo: Container<br />Antepassado: LifecycleConfiguration | Sim | 
|  Status  | Se habilitado, o Amazon S3 vai executar a regra conforme programado. Se desabilitado, o Amazon S3 vai ignorar a regra.<br />Tipo: string<br />Antepassado: Rule<br />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.<br />Tipo: string<br />Antepassado: Transition e NoncurrentVersionTransition<br />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.<br /> +  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.  <br />+  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. <br />  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`.  <br />Tipo: Container<br />Filhos: Days ou Date e StorageClass<br />Antepassado: Rule | Sim, se nenhuma outra ação estiver presente na Rule | 

## Erros especiais
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| 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](ErrorResponses.md).

## Exemplos
<a name="v1-rel-RESTBucketGETlifecycle-examples"></a>

### Exemplo 1: recuperar um sub-recurso do ciclo de vida
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

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
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-request"></a>

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

#### Resposta da amostra
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
 3. x-amz-request-id: 51991C342C575321
 4. Date: Thu, 15 Nov 2012 00:17:23 GMT
 5. Server: AmazonS3
 6. Content-Length: 358
 7. 
 8. <?xml version="1.0" encoding="UTF-8"?>
 9. <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
10.     <Rule>
11.         <ID>Archive and then delete rule</ID>
12.         <Prefix>projectdocs/</Prefix>
13.         <Status>Enabled</Status>
14.        <Transition>
15.            <Days>30</Days>
16.            <StorageClass>STANDARD_IA</StorageClass>
17.         </Transition>
18.         <Transition>
19.            <Days>365</Days>
20.            <StorageClass>GLACIER</StorageClass>
21.         </Transition>
22.         <Expiration>
23.            <Days>3650</Days>
24.         </Expiration>
25.     </Rule>
26. </LifecycleConfiguration>
```

## Recursos relacionados
<a name="v1-rel-RESTBucketGETlifecycle-related-resources"></a>
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [DeleteBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)