View a markdown version of this page

Ciclo de vida de bucket GET (obsoleto) - Amazon Simple Storage Service
DescripciónSolicitudesRespuestasErrores especialesEjemplosActivos relacionados

Ciclo de vida de bucket GET (obsoleto)

Descripción

importante

Para obtener una versión actualizada de esta API, consulte GetBucketLifecycleConfiguration. 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 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 en la Guía del usuario de Amazon Simple Storage Service.

Solicitudes

Sintaxis

GET /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Date: date
Authorization: authorization string (see Autenticación de solicitudes (AWS Signature Version 4))

Parámetros de la solicitud

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

Encabezados de solicitud

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.

Elementos de la solicitud

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

Respuestas

Encabezados de respuesta

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.

Elementos de respuesta

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

Tipo: Contenedor

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 en la Guía del usuario de Amazon Simple Storage Service.

El valor de la fecha debe estar en formato ISO 8601. La hora siempre es medianoche UTC.

Tipo: cadena

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.

Tipo: entero no negativo cuando se usa con Transition, entero positivo cuando se usa con Expiration.

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.

Tipo: entero positivo

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.

  • Si el control de versiones nunca se ha habilitado en el bucket, Amazon S3 elimina la única copia del objeto de forma permanente.

  • 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.

    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.

    importante

    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.

    nota

    Para establecer la caducidad de los objetos no actuales, debe usar la acción NoncurrentVersionExpiration.

Tipo: Contenedor

Secundario: Días o Fecha

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.

Tipo: cadena

Antecesor: Rule

 No
LifecycleConfiguration

Contenedor para las reglas del ciclo de vida. Puede añadir hasta 1000 reglas.

Tipo: Contenedor

Secundario: Regla

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 en la Guía del usuario de Amazon Simple Storage Service.

Tipo: cadena

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)

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 en la Guía del usuario de Amazon Simple Storage Service.

Tipo: entero no negativo cuando se usa con NoncurrentVersionTransition, entero positivo cuando se usa con NoncurrentVersionExpiration

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.

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.

Tipo: Contenedor

Secundario: NoncurrentDays

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.

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.

Tipo: Contenedor

Secundario: NoncurrentDays y StorageClass

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.

Tipo: cadena

Antecesor: Rule

 Sí
Rule

Contenedor para una regla del ciclo de vida.

Tipo: Contenedor

Antecesor: LifecycleConfiguration

 Sí
Status

Si está habilitada, Amazon S3 ejecuta la regla según lo programado. Si está desactivada, Amazon S3 ignora la regla.

Tipo: cadena

Antecesor: Rule

Valores válidos: Habilitado o Desactivado

 Sí
StorageClass

Especifica la clase de almacenamiento de Amazon S3 a la que quiere que pase el objeto.

Tipo: cadena

Antecesor: Transition y NoncurrentVersionTransition

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.

  • 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.

  • 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.

    nota

    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.

Tipo: Contenedor

Secundario: Días o Fecha y StorageClass

Antecesor: Rule

 Sí, si no hay ninguna otra acción presente en la Rule

Errores especiales

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.

Ejemplos

Ejemplo 1: Recuperar un subrecurso del ciclo de vida

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

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

Respuesta de ejemplo

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>