# Ciclo de vida de bucket GET (obsoleto)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

## Descripción
<a name="v1-rel-RESTBucketGETlifecycle_Description"></a>



 

**importante**  
Para obtener una versión actualizada de esta API, consulte [GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html). Si configuró el ciclo de vida de un bucket con el elemento <filter>, debería ver una versión actualizada de este tema. Este tema se proporciona por compatibilidad con versiones anteriores. 

Devuelve la información de configuración de `lifecycle` establecida en el bucket. Para obtener información sobre la configuración del ciclo de vida, vaya a [Administración del ciclo de vida de los objetos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) en la *Guía del usuario de Amazon Simple Storage Service*. 

Para usar esta operación, debe tener el permiso para realizar la acción `s3:GetLifecycleConfiguration`. De forma predeterminada, el propietario del bucket tiene este permiso. El propietario del bucket puede conceder este permiso a otros. Para obtener más información sobre los permisos, consulte [Administración de los permisos de acceso a los recursos de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) en la *Guía del usuario de Amazon Simple Storage Service*.

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

### Sintaxis
<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 Autenticación de solicitudes (AWS Signature Version 4))
```

### Parámetros de la solicitud
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

Esta aplicación de la operación no utiliza parámetros de solicitud.

### Encabezados de solicitud
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

Esta implementación de la operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener más información, consulte [Encabezados de solicitud comunes](RESTCommonRequestHeaders.md).

### Elementos de la solicitud
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

Esta implementación de la operación no utiliza elementos de solicitud.

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

### Encabezados de respuesta
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

Esta implementación de la operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener más información, consulte [Encabezados de respuesta comunes](RESTCommonResponseHeaders.md).

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

Esta implementación de `GET` devuelve los siguientes elementos de respuesta.


|  Nombre  |  Descripción  | Obligatorio | 
| --- | --- | --- | 
|  AbortIncompleteMultipartUpload  | Contenedor para especificar cuándo una carga multiparte incompleta pasa a ser apta para una operación de anulación.Elemento secundario: `DaysAfterInitiation`<br />Tipo: Contenedor<br />Antecesor: `Rule` | Sí, si no se especifica ninguna otra acción para la regla | 
|  Date  | La fecha en la que desea que Amazon S3 realice la acción. Para obtener más información, consulte [Reglas de ciclo de vida: en función de una fecha específica](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date) en la *Guía del usuario de Amazon Simple Storage Service*.<br />El valor de la fecha debe estar en formato ISO 8601. La hora siempre es medianoche UTC. <br />Tipo: cadena<br />Antecesor: `Expiration` o `Transition` | Sí, si Days y ExpiredObjectDeleteMarker están ausentes | 
|  Days  | Especifica el número de días después de la creación del objeto cuando entra en vigor la acción de regla específica. El tiempo de aptitud del objeto se calcula como el tiempo de creación más el número de días, redondeando el tiempo resultante a la medianoche UTC del día siguiente.<br />Tipo: entero no negativo cuando se usa con `Transition`, entero positivo cuando se usa con `Expiration`.<br />Antecesor: `Transition` o `Expiration` | Sí, si Date y ExpiredObjectDeleteMarker están ausentes | 
|  DaysAfterInitiation  | Especifica el número de días después de iniciar una carga multiparte en los que debe completarse la carga multiparte. Si no se completa en el número de días especificado, se podrá aplicar una operación de anulación y Amazon S3 cancela la carga multiparte incompleta.<br />Tipo: entero positivo<br />Antecesor: `AbortIncompleteMultipartUpload` | Sí, si Date está ausente | 
|  Expiration  | Esta acción especifica un periodo de la vida útil del objeto en el que Amazon S3 debe llevar a cabo la acción de caducidad adecuada. La acción de caducidad solo se produce en los objetos que son aptos según el periodo especificado en el elemento secundario `Date` o `Days`. La acción que tome Amazon S3 depende de si el bucket tiene habilitado el control de versiones. <br /> +  Si el control de versiones nunca se ha habilitado en el bucket, Amazon S3 elimina la única copia del objeto de forma permanente.  <br />+  De lo contrario, si el bucket tiene el control de versiones habilitado (o el control de versiones está suspendido), la acción se aplica solo a la versión actual del objeto. Los buckets que tienen habilitado o suspendido el control de versiones, pueden tener muchas versiones del mismo objeto: una versión actual y ninguna o varias versiones no actuales. <br />En lugar de eliminar la versión actual, Amazon S3 la convierte en una versión no actual agregándole un marcador de eliminación como la nueva versión actual.  <br />  Si el estado de un bucket es con el control de versiones suspendido, Amazon S3 crea un marcador de eliminación con el ID de versión `null`. Si tiene una versión con un ID de versión `null`, Amazon S3 sobrescribe esa versión.   <br />  Para establecer la caducidad de los objetos no actuales, debe usar la acción `NoncurrentVersionExpiration`.  <br />Tipo: Contenedor<br />Secundario: Días o Fecha<br />Antecesor: Rule | Sí, si se especifica la etiqueta principal | 
|  ID  | Identificador único de la regla. El valor no puede tener más de 255 caracteres.<br />Tipo: cadena<br />Antecesor: Rule | No | 
| LifecycleConfiguration  | Contenedor para las reglas del ciclo de vida. Puede añadir hasta 1000 reglas.<br />Tipo: Contenedor<br />Secundario: Regla<br />Ancestor: ninguno | Sí | 
| ExpiredObjectDeleteMarker | En un bucket con control de versiones (un bucket con el control de versiones habilitado o suspendido), este elemento indica si Amazon S3 eliminará los marcadores de eliminación de objetos caducados en el bucket. Para ver un ejemplo, vaya a [Ejemplo 8: Especificar acción de vencimiento para eliminar marcadores de eliminación de objetos caducados](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8) en la *Guía del usuario de Amazon Simple Storage Service*.<br />Tipo: cadena <br />Valores válidos: true \| false (el valor false está permitido pero no es operativo, Amazon S3 no realiza ninguna acción si el valor es false)<br />Antecesor: `Expiration` | Sí, si Date y Days están ausentes | 
| NoncurrentDays  | Especifica el número de días que un objeto no es actual antes de que Amazon S3 pueda realizar la acción asociada. Para obtener información sobre el cálculo de los días no actuales, consulte [Reglas del ciclo de vida basadas en el número de días](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days) en la *Guía del usuario de Amazon Simple Storage Service*.<br />Tipo: entero no negativo cuando se usa con `NoncurrentVersionTransition`, entero positivo cuando se usa con `NoncurrentVersionExpiration`<br />Antecesor: `NoncurrentVersionExpiration` o `NoncurrentVersionTransition` | Sí, solo si el antecesor está presente | 
| NoncurrentVersionExpiration  | Especifica cuándo expiran las versiones de objetos no actuales. Cuando expiran, Amazon S3 elimina de forma permanente las versiones de objetos no actuales. <br />Establezca esta acción de configuración del ciclo de vida en un bucket que tenga habilitado (o suspendido) el control de versiones a fin de solicitar que Amazon S3 elimine las versiones de objetos no actuales en un periodo específico de la vida útil del objeto.<br />Tipo: Contenedor<br />Secundario: NoncurrentDays <br />Antecesor: Rule | Sí, si no hay ninguna otra acción presente en la Rule | 
| NoncurrentVersionTransition | Contenedor de la regla de transición que describe cuándo los objetos no actuales se transfieren a `STANDARD_IA`, `ONEZONE_IA` o la clase de almacenamiento. <br />Si el bucket tiene habilitado (o desactivado) el control de versiones, puede establecer esta acción para solicitar que Amazon S3 transfiera las versiones de objetos no actuales a la clase de almacenamiento en un periodo específico de la vida útil del objeto.<br />Tipo: Contenedor<br />Secundario: NoncurrentDays y StorageClass<br />Antecesor: Rule | Sí, si no hay ninguna otra acción presente en la Rule | 
|  Prefix  | Prefijo de clave de objeto que identifica uno o varios objetos a los que se aplica la regla.<br />Tipo: cadena<br />Antecesor: Rule | Sí | 
| Rule  | Contenedor para una regla del ciclo de vida.<br />Tipo: Contenedor<br />Antecesor: LifecycleConfiguration | Sí | 
|  Status  | Si está habilitada, Amazon S3 ejecuta la regla según lo programado. Si está desactivada, Amazon S3 ignora la regla.<br />Tipo: cadena<br />Antecesor: Rule<br />Valores válidos: Habilitado o Desactivado | Sí | 
|  StorageClass  | Especifica la clase de almacenamiento de Amazon S3 a la que quiere que pase el objeto.<br />Tipo: cadena<br />Antecesor: Transition y NoncurrentVersionTransition<br />Valores válidos: `STANDARD_IA` \| `ONEZONE_IA` \|  | Sí | 
|  Transition  | Esta acción especifica un periodo de la vida útil de los objetos en el que Amazon S3 debe hacer la transición a `STANDARD_IA`, `ONEZONE_IA` o clase de almacenamiento. Cuando esta acción esté en vigor, lo que haga Amazon S3 dependerá de si el bucket tiene habilitado el control de versiones.<br /> +  Si el control de versiones no se habilitado nunca en el bucket, Amazon S3 pasa la única copia del objeto a la clase de almacenamiento especificada.  <br />+  Cuando el bucket tiene habilitado (o suspendido) el control de versiones, Amazon S3 pasa solo las versiones actuales de los objetos identificados en la regla. <br />  Un bucket con control de versiones habilitado o suspendido puede contener varias versiones de un objeto. Esta acción no afecta a las versiones de objetos no actuales. Para realizar la transición de objetos no actuales, debe utilizar la acción `NoncurrentVersionTransition`.  <br />Tipo: Contenedor<br />Secundario: Días o Fecha y StorageClass<br />Antecesor: Rule | Sí, si no hay ninguna otra acción presente en la Rule | 

## Errores especiales
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| Código de error | Descripción | Código de estado HTTP | Prefijo de código de error de SOAP | 
| --- | --- | --- | --- | 
| NoSuchLifecycleConfiguration | La configuración del ciclo de vida no existe.  | 404 Not Found (No encontrado) | Cliente | 

Para obtener información general sobre los errores de Amazon S3 y una lista de códigos de error, consulte [Respuestas de error](ErrorResponses.md).

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

### Ejemplo 1: Recuperar un subrecurso del ciclo de vida
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

Este ejemplo es una solicitud GET para recuperar el subrecurso `lifecycle` del bucket especificado y un ejemplo de respuesta con la configuración del ciclo de vida devuelta. 

#### Solicitud de muestra
<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}}
```

#### Respuesta de ejemplo
<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>
```

## Activos 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)