

# Configurar el Bloqueo de objetos de S3
<a name="object-lock-configure"></a>

Bloqueo de objetos de Amazon S3 le permite almacenar objetos en los buckets de uso general de Amazon S3 con un modelo de *escritura única y lectura múltiple* (WORM). Puede usar el bloqueo de objetos de S3 para evitar que se elimine o se sobrescriba un objeto durante un periodo de tiempo determinado o de manera indefinida. Para obtener información general acerca de las capacidades de Bloqueo de objetos, consulte [Bloqueo de objetos mediante Bloqueo de objetos](object-lock.md).

Antes de bloquear cualquier objeto, debe habilitar el control de versiones y el bloqueo de objetos de S3 en un bucket de uso general. Posteriormente, puede establecer un periodo de retención, una retención legal o ambas opciones. 

Para trabajar con Bloqueo de objetos, debe contar con determinados permisos. Para obtener una lista de los permisos relacionados con diversas operaciones de bloqueo de objetos, consulte [Permisos necesarios](object-lock.md#object-lock-permissions).

**importante**  
Una vez que active el bloqueo de objetos en un bucket, no puede desactivarlo ni suspender el control de versiones en ese bucket. 
Los buckets de S3 con bloqueo de objetos no se pueden utilizar como buckets de destino para los registros de acceso al servidor. Para obtener más información, consulte [Registro de solicitudes con registro de acceso al servidor](ServerLogs.md).

**Topics**
+ [Activación de Bloqueo de objetos al crear un nuevo bucket de uso general de S3](#object-lock-configure-new-bucket)
+ [Activación de Bloqueo de objetos en un bucket de S3 existente](#object-lock-configure-existing-bucket)
+ [Establecer o modificar una retención legal en un objeto de S3](#object-lock-configure-set-legal-hold)
+ [Establecer o modificar un período de retención en un objeto de S3](#object-lock-configure-set-retention-period-object)
+ [Establecer o modificar un período de retención predeterminado en un bucket de S3](#object-lock-configure-set-retention-period-bucket)

## Activación de Bloqueo de objetos al crear un nuevo bucket de uso general de S3
<a name="object-lock-configure-new-bucket"></a>

Puede habilitar Bloqueo de objetos al crear un bucket de uso general de S3 nuevo a través de la consola de Amazon S3, AWS Command Line Interface (AWS CLI), los SDK de AWS o la API de REST de Amazon S3.

### Uso de la consola de S3
<a name="object-lock-new-bucket-console"></a>

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets de uso general**.

1. Elija **Crear bucket**.

   Se abrirá la página **Crear bucket**.

1. En **Nombre del bucket**, escriba un nombre para el bucket.
**nota**  
Una vez que haya creado un bucket, no podrá modificar su nombre. Para obtener más información sobre la nomenclatura de los buckets, consulte [Reglas de nomenclatura de buckets de uso general](bucketnamingrules.md).

1. En **Región**, elija la Región de AWS en la que desea que se encuentre el bucket. 

1. En **Propiedad de objetos**, elija esta opción para desactivar o habilitar las listas de control de acceso (ACL) y controlar la propiedad de los objetos cargados en el bucket:

1. En **Configuración de bloqueo de acceso público para este bucket**, elija la configuración Bloquear acceso público que desee aplicar al bucket. 

1. En **Versiones del bucket**, elija **Editar**.

   El Bloqueo de objetos solo funciona con buckets versionados.

1. (Opcional) En **Tags** (Etiquetas), puede elegir añadir etiquetas a su bucket. Las etiquetas son pares clave-valor que se utilizan para categorizar el almacenamiento y asignar los costes.

1. En **Configuración avanzada**, busque **Bloqueo de objetos** y elija **Habilitar**.

   Debe reconocer que si habilita el bloqueo de objetos, se bloquearán permanentemente los objetos de este bucket.

1. Elija **Crear bucket**.

### Uso de AWS CLI
<a name="object-lock-new-bucket-cli"></a>

En el siguiente ejemplo `create-bucket` se crea un nuevo bucket de S3 denominado `amzn-s3-demo-bucket1` con Bloqueo de objetos activado:

```
aws s3api create-bucket --bucket amzn-s3-demo-bucket1 --object-lock-enabled-for-bucket
```

Para obtener más información y ejemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) en la *referencia de comandos de AWS CLI*.

**nota**  
Puede ejecutar comandos de AWS CLI desde la consola mediante AWS CloudShell. AWS CloudShell es un intérprete de comandos previamente autenticado y basado en el navegador que se puede lanzar directamente desde la página web de la Consola de administración de AWS. Para obtener más información, consulte [¿Qué es CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) en la *Guía del usuario de AWS CloudShell*.

### Uso de la API de REST
<a name="object-lock-new-bucket-rest"></a>

Puede utilizar la API de REST para crear un bucket de S3 nuevo con Bloqueo de objetos activado. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) en la *Referencia de la API de Amazon Simple Storage Service*.

### Uso de los AWS SDK
<a name="object-lock-new-bucket-sdk"></a>

Para ver ejemplos de cómo habilitar Bloqueo de objetos al crear un nuevo bucket de S3 con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_LCreateBucket_section.html) en la *Amazon S3 API Reference*.

Para ver ejemplos de cómo obtener la configuración actual de Bloqueo de objetos con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) en la *Amazon S3 API Reference*.

Para ver un escenario interactivo que muestre diferentes características de Bloqueo de objetos con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) en la *Amazon S3 API Reference*.

Para obtener información general sobre el uso de diferentes AWS SDK, consulte [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) en la *Amazon S3 API Reference*.

## Activación de Bloqueo de objetos en un bucket de S3 existente
<a name="object-lock-configure-existing-bucket"></a>

Puede habilitar el bloqueo de objetos para un bucket de S3 existente a través de la consola de Amazon S3, la AWS CLI, los SDK de AWS o la API de REST de Amazon S3.

### Uso de la consola de S3
<a name="object-lock-existing-bucket-console"></a>

**nota**  
El Bloqueo de objetos solo funciona con buckets versionados.

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets**.

1. En la lista **Buckets**, elija el nombre del bucket para el que desea activar el Bloqueo de objetos de S3.

1. Elija la pestaña **Propiedades**.

1. En **Propiedades**, desplácese hacia abajo hasta la sección **Bloqueo de objetos** y seleccione **Editar**.

1. En **Bloqueo de objetos**, seleccione **Habilitar**.

   Debe reconocer que si habilita el bloqueo de objetos, se bloquearán permanentemente los objetos de este bucket.

1. Elija **Save changes (Guardar cambios)**.



### Mediante AWS CLI
<a name="object-lock-existing-bucket-cli"></a>

El siguiente comando de ejemplo `put-object-lock-configuration` establece un período de retención de 50 días para el Bloqueo de objetos en un bucket denominado `amzn-s3-demo-bucket1`:

```
aws s3api put-object-lock-configuration --bucket amzn-s3-demo-bucket1 --object-lock-configuration='{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 50 }}}'
```

Para obtener más información y ejemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-lock-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-lock-configuration.html) en la *referencia de comandos de AWS CLI*.

**nota**  
Puede ejecutar comandos de AWS CLI desde la consola mediante AWS CloudShell. AWS CloudShell es un intérprete de comandos previamente autenticado y basado en el navegador que se puede lanzar directamente desde la página web de la Consola de administración de AWS. Para obtener más información, consulte [¿Qué es CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) en la *Guía del usuario de AWS CloudShell*.

### Uso de la API de REST
<a name="object-lock-existing-bucket-rest"></a>

Puede utilizar la API de REST de Amazon S3 para habilitar el bloqueo de objetos en un bucket de S3 existente. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html) en la *Referencia de la API de Amazon Simple Storage Service*.

### Uso de los AWS SDK
<a name="object-lock-existing-bucket-sdk"></a>

Para ver ejemplos de cómo habilitar Bloqueo de objetos para un bucket de S3 existente con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectLockConfiguration_section.html) en la *Amazon S3 API Reference*.

Para ver ejemplos de cómo obtener la configuración actual de Bloqueo de objetos con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) en la *Amazon S3 API Reference*.

Para ver un escenario interactivo que muestre diferentes características de Bloqueo de objetos con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) en la *Amazon S3 API Reference*.

Para obtener información general sobre el uso de diferentes AWS SDK, consulte [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) en la *Amazon S3 API Reference*.

## Establecer o modificar una retención legal en un objeto de S3
<a name="object-lock-configure-set-legal-hold"></a>

Puede establecer o eliminar una retención legal en un objeto de S3 mediante la consola de Amazon S3, AWS CLI, los SDK de AWS o la API de REST de Amazon S3.

**importante**  
Si desea establecer una retención legal en un objeto, el bucket del objeto debe tener ya activado el bloqueo de objetos.
Cuando se aplica `PUT` a la versión de un objeto que tiene un modo y un periodo de retención individual explícitos en un bucket, la configuración de bloqueo de objetos individual de la versión del objeto anula cualquier configuración de retención para las propiedades del bucket.

Para obtener más información, consulte [Retenciones legales](object-lock.md#object-lock-legal-holds).

### Uso de la consola de S3
<a name="object-lock-set-legal-hold-console"></a>

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets**.

1. En la lista **Buckets**, seleccione el nombre del bucket que contiene el objeto sobre el que desee establecer o modificar una retención legal.

1. En la lista **Objetos**, seleccione el objeto sobre el que desee establecer o modificar una retención legal.

1. En la página **Propiedades del objeto**, busque la sección **Retención legal de bloqueo de objetos** y seleccione **Editar**.

1. Seleccione **Habilitar** para establecer una retención legal o **Deshabilitar** para eliminar una retención legal.

1. Elija **Guardar cambios**.

### Mediante AWS CLI
<a name="object-lock-set-legal-hold-cli"></a>

En el siguiente ejemplo `put-object-legal-hold` se establece una retención legal sobre el objeto *`my-image.fs`* en el bucket denominado `amzn-s3-demo-bucket1`:

```
aws s3api put-object-legal-hold --bucket amzn-s3-demo-bucket1 --key my-image.fs --legal-hold="Status=ON"
```

En el siguiente ejemplo `put-object-legal-hold` se elimina una retención legal sobre el objeto *`my-image.fs`* en el bucket denominado `amzn-s3-demo-bucket1`:

```
aws s3api put-object-legal-hold --bucket amzn-s3-demo-bucket1 --key my-image.fs --legal-hold="Status=OFF"
```

Para obtener más información y ejemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-legal-hold.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-legal-hold.html) en la *referencia de comandos de AWS CLI*.

**nota**  
Puede ejecutar comandos de AWS CLI desde la consola mediante AWS CloudShell. AWS CloudShell es un intérprete de comandos previamente autenticado y basado en el navegador que se puede lanzar directamente desde la página web de la Consola de administración de AWS. Para obtener más información, consulte [¿Qué es CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) en la *Guía del usuario de AWS CloudShell*.

### Uso de la API de REST
<a name="object-lock-set-legal-hold-rest"></a>

Puede utilizar la API de REST para establecer o modificar una retención legal en un objeto. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLegalHold.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLegalHold.html) en la *Referencia de la API de Amazon Simple Storage Service*.

### Uso de los AWS SDK
<a name="object-lock-set-legal-hold-sdk"></a>

Para ver ejemplos de cómo establecer una retención legal sobre un objeto con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectLegalHold_section.html) en la *Amazon S3 API Reference*.

Para ver ejemplos de cómo obtener el estado de la retención legal actual con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLegalHoldConfiguration_section.html) en la *Amazon S3 API Reference*.

Para ver un escenario interactivo que muestre diferentes características de Bloqueo de objetos con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) en la *Amazon S3 API Reference*.

Para obtener información general sobre el uso de diferentes AWS SDK, consulte [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) en la *Amazon S3 API Reference*.

## Establecer o modificar un período de retención en un objeto de S3
<a name="object-lock-configure-set-retention-period-object"></a>

Puede establecer o modificar un período de retención en un objeto de S3 mediante la consola de Amazon S3, AWS CLI, los SDK de AWS o la API de REST de Amazon S3.

**importante**  
Si desea establecer un período de retención en un objeto, el bucket del objeto debe tener ya activado el bloqueo de objetos.
Cuando se aplica `PUT` a la versión de un objeto que tiene un modo y un periodo de retención individual explícitos en un bucket, la configuración de bloqueo de objetos individual de la versión del objeto anula cualquier configuración de retención para las propiedades del bucket.
La única forma de eliminar un objeto en el modo de cumplimiento antes de que venza su fecha de retención es eliminar la Cuenta de AWS asociada.

Para obtener más información, consulte [Periodos de retención](object-lock.md#object-lock-retention-periods).

### Uso de la consola de S3
<a name="object-lock-set-retention-period-console"></a>

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets**.

1. En la lista **Buckets**, seleccione el nombre del bucket que contiene el objeto sobre el que desee establecer o modificar un período de retención.

1. En la lista **Objetos**, seleccione el objeto sobre el que desee establecer o modificar un período de retención.

1. En la página **Propiedades del objeto**, busque la sección **Retención de bloqueo de objetos** y seleccione **Editar**.

1. En **Retención**, seleccione **Habilitar** para establecer un período de retención o **Deshabilitar** para eliminar un período de retención.

1. Si se ha seleccionado **Habilitar**, en **Modo de retención**, elija el **modo Gobierno** o el **modo Cumplimiento**. Para obtener más información, consulte [Modos de retención](object-lock.md#object-lock-retention-modes).

1. En **Fecha límite de retención**, elija la fecha en la que desea que finalice el período de retención. Durante este periodo, el objeto tiene protección WORM y no es posible sobrescribirlo ni eliminarlo. Para obtener más información, consulte [Periodos de retención](object-lock.md#object-lock-retention-periods).

1. Elija **Save changes (Guardar cambios)**.

### Mediante AWS CLI
<a name="object-lock-set-retention-period-cli"></a>

En el siguiente ejemplo `put-object-retention` se establece un período de retención sobre el objeto *`my-image.fs`* en el bucket denominado `amzn-s3-demo-bucket1` hasta el 1 de enero de 2025:

```
aws s3api put-object-retention --bucket amzn-s3-demo-bucket1 --key my-image.fs --retention='{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'
```

Para obtener más información y ejemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-retention.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-retention.html) en la *referencia de comandos de AWS CLI*.

**nota**  
Puede ejecutar comandos de AWS CLI desde la consola mediante AWS CloudShell. AWS CloudShell es un intérprete de comandos previamente autenticado y basado en el navegador que se puede lanzar directamente desde la página web de la Consola de administración de AWS. Para obtener más información, consulte [¿Qué es CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) en la *Guía del usuario de AWS CloudShell*.

### Uso de la API de REST
<a name="object-lock-set-retention-period-rest"></a>

Puede utilizar la API de REST para establecer un periodo de retención en un objeto. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectRetention.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectRetention.html) en la *Referencia de la API de Amazon Simple Storage Service*.

### Uso de los AWS SDK
<a name="object-lock-set-retention-period-sdk"></a>

Para ver ejemplos de cómo configurar un periodo de retención en un objeto con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectRetention_section.html) en la *Amazon S3 API Reference*.

Para ver ejemplos de cómo obtener el periodo de retención en un objeto con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) en la *Amazon S3 API Reference*.

Para ver un escenario interactivo que muestre diferentes características de Bloqueo de objetos con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) en la *Amazon S3 API Reference*.

Para obtener información general sobre el uso de diferentes AWS SDK, consulte [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) en la *Amazon S3 API Reference*.

## Establecer o modificar un período de retención predeterminado en un bucket de S3
<a name="object-lock-configure-set-retention-period-bucket"></a>

Puede establecer o modificar un período de retención predeterminado en un bucket de S3 mediante la consola de Amazon S3, AWS CLI, los SDK de AWS o la API de REST de Amazon S3. Se especifica una duración, en días o años, para proteger cada versión del objeto colocada en el bucket.

**importante**  
Si desea establecer un periodo de retención predeterminado en un bucket, el bucket debe contar ya con Bloqueo de objetos activado.
Cuando se aplica `PUT` a la versión de un objeto que tiene un modo y un periodo de retención individual explícitos en un bucket, la configuración de bloqueo de objetos individual de la versión del objeto anula cualquier configuración de retención para las propiedades del bucket.
La única forma de eliminar un objeto en el modo de cumplimiento antes de que venza su fecha de retención es eliminar la Cuenta de AWS asociada.

Para obtener más información, consulte [Periodos de retención](object-lock.md#object-lock-retention-periods).

### Uso de la consola de S3
<a name="object-lock-set-retention-period-bucket-console"></a>

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets**.

1. En la lista **Buckets**, seleccione el nombre del bucket sobre el que desea establecer o modificar un período de retención predeterminado.

1. Elija la pestaña **Propiedades**.

1. En **Propiedades**, desplácese hacia abajo hasta la sección **Bloqueo de objetos** y seleccione **Editar**.

1. En **Retención predeterminada**, seleccione **Habilitar** para establecer un período de retención o **Deshabilitar** para eliminar un período de retención.

1. Si se ha seleccionado **Habilitar**, en **Modo de retención**, elija el **modo Gobierno** o el **modo Cumplimiento**. Para obtener más información, consulte [Modos de retención](object-lock.md#object-lock-retention-modes).

1. En **Período de retención predeterminado**, seleccione el número de días o años que desea que dure el período de retención. Los objetos que se coloquen en este bucket se bloquearán durante ese número de días o años. Para obtener más información, consulte [Periodos de retención](object-lock.md#object-lock-retention-periods).

1. Elija **Save changes (Guardar cambios)**.

### Mediante AWS CLI
<a name="object-lock-configure-set-retention-period-bucket-cli"></a>

El siguiente comando de ejemplo `put-object-lock-configuration` establece un período de retención de Bloqueo de objetos de 50 días en un bucket denominado `amzn-s3-demo-bucket1` mediante el modo de cumplimiento:

```
aws s3api put-object-lock-configuration --bucket amzn-s3-demo-bucket1 --object-lock-configuration='{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 50 }}}'
```

En el siguiente ejemplo `put-object-lock-configuration` se elimina la configuración de retención predeterminada de un bucket:

```
aws s3api put-object-lock-configuration --bucket amzn-s3-demo-bucket1 --object-lock-configuration='{ "ObjectLockEnabled": "Enabled"}'
```

Para obtener más información y ejemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-lock-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-lock-configuration.html) en la *referencia de comandos de AWS CLI*.

**nota**  
Puede ejecutar comandos de AWS CLI desde la consola mediante AWS CloudShell. AWS CloudShell es un intérprete de comandos previamente autenticado y basado en el navegador que se puede lanzar directamente desde la página web de la Consola de administración de AWS. Para obtener más información, consulte [¿Qué es CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) en la *Guía del usuario de AWS CloudShell*.

### Uso de la API de REST
<a name="object-lock-configure-set-retention-period-bucket-rest"></a>

Puede utilizar la API de REST para establecer un periodo de retención predeterminado en un bucket de S3 existente. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html) en la *Referencia de la API de Amazon Simple Storage Service*.

### Uso de los AWS SDK
<a name="object-lock-configure-set-retention-period-bucket-sdk"></a>

Para ver ejemplos de cómo establecer un periodo de retención predeterminado en un bucket de S3 existente con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectLockConfiguration_section.html) en la *Amazon S3 API Reference*.

Para ver un escenario interactivo que muestre diferentes características de Bloqueo de objetos con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) en la *Amazon S3 API Reference*.

Para obtener información general sobre el uso de diferentes AWS SDK, consulte [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) en la *Amazon S3 API Reference*.