

# Configurar a funcionalidade Bloqueio de Objetos do S3
<a name="object-lock-configure"></a>

Com a funcionalidade Bloqueio de Objetos do Amazon S3, é possível armazenar objetos em buckets de uso geral no Amazon S3 usando um modelo de *gravação única e várias leituras* (WORM). Você pode usar o bloqueio de objetos do S3 para evitar que um objeto seja excluído ou substituído por um período fixo ou indefinidamente. Para obter informações gerais sobre os recursos da funcionalidade Bloqueio de Objetos, consulte [Bloquear objetos com o Bloqueio de Objetos](object-lock.md).

Antes de bloquear qualquer objeto, é necessário habilitar as funcionalidades Versionamento e Bloqueio de Objetos do S3 em um bucket de uso geral. Depois, você pode definir um período de retenção, uma retenção jurídica ou ambos. 

Para trabalhar com a funcionalidade Bloqueio de Objetos, é necessário ter determinadas permissões. Para obter uma lista das permissões relacionadas a várias operações da funcionalidade Bloqueio de Objetos, consulte [Permissões obrigatórias](object-lock.md#object-lock-permissions).

**Importante**  
Depois de habilitar a funcionalidade Bloqueio de Objetos em um bucket, não será possível desabilitá-la nem suspender o versionamento nesse bucket. 
Os buckets do S3 com funcionalidade Bloqueio de Objetos não podem ser usados como buckets de destino para logs de acesso ao servidor. Para obter mais informações, consulte [Registrar em log as solicitações com registro em log de acesso ao servidor](ServerLogs.md).

**Topics**
+ [Habilitar a funcionalidade Bloqueio de Objetos ao criar um bucket de uso geral do S3](#object-lock-configure-new-bucket)
+ [Habilitar a funcionalidade Bloqueio de Objetos em um bucket do S3 existente](#object-lock-configure-existing-bucket)
+ [Definir ou modificar uma retenção jurídica em um objeto do S3](#object-lock-configure-set-legal-hold)
+ [Definir ou modificar um período de retenção em um objeto do S3](#object-lock-configure-set-retention-period-object)
+ [Definir ou modificar um período de retenção padrão em um bucket do S3](#object-lock-configure-set-retention-period-bucket)

## Habilitar a funcionalidade Bloqueio de Objetos ao criar um bucket de uso geral do S3
<a name="object-lock-configure-new-bucket"></a>

Você pode habilitar a funcionalidade Bloqueio de Objetos ao criar um bucket de uso geral do S3 usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), os AWS SDKs ou a API REST do Amazon S3.

### Usar o console do S3
<a name="object-lock-new-bucket-console"></a>

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets de uso geral**.

1. Selecione **Create bucket (Criar bucket)**.

   A página **Create bucket** (Criar bucket) é aberta.

1. Para **Nome do bucket**, insira um nome para o bucket.
**nota**  
Depois de criar um bucket, não será possível mudar o nome dele. Para obter mais informações sobre como nomear buckets, consulte [Regras de nomenclatura de buckets de uso geral](bucketnamingrules.md).

1. Em **Region** (Região), escolha a Região da AWS onde deseja que o bucket resida. 

1. Em **Propriedade de Objetos**, escolha desabilitar ou habilitar as listas de controle de acesso (ACLs) e controlar a propriedade de objetos carregados no bucket.

1. Em **Configurações de bloqueio de acesso público para este bucket**, selecione as configurações de bloqueio de acesso público que deseja aplicar ao bucket. 

1. Em **Versionamento de bucket**, escolha **Habilitado**.

   A funcionalidade Bloqueio de Objetos só funciona em buckets com versionamento.

1. (Opcional) Em **Tags** (Etiquetas), você pode optar por adicionar etiquetas ao seu bucket. As etiquetas são pares de chave-valor usados para categorizar o armazenamento e alocar os custos.

1. Em **Configurações avançadas**, encontre **Bloqueio de objeto** e escolha **Habilitar**.

   Você deve reconhecer que a ativação da funcionalidade Bloqueio de Objetos permitirá permanentemente que os objetos desse bucket sejam bloqueados.

1. Selecione **Criar bucket**.

### Como usar o AWS CLI
<a name="object-lock-new-bucket-cli"></a>

O seguinte exemplo `create-bucket` cria um bucket do S3 chamado `amzn-s3-demo-bucket1` com a funcionalidade Bloqueio de Objetos habilitada:

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

Para obter mais informações e exemplos, 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) na *Referência de comandos da AWS CLI*.

**nota**  
Você pode executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode inicializar diretamente do Console de gerenciamento da AWS. Para obter mais informações, consulte [What is CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) no *Guia do usuário do AWS CloudShell*.

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

É possível usar a API REST para criar um bucket do S3 com a funcionalidade Bloqueio de Objetos habilitada. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) na *Referência da API do Amazon Simple Storage Service*.

### Usar SDKs da AWS
<a name="object-lock-new-bucket-sdk"></a>

Consulte exemplos de como habilitar o Bloqueio de Objetos ao criar um bucket do S3 com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_LCreateBucket_section.html) na *Referência de API do Amazon S3*.

Consulte exemplos de como obter a configuração atual do Bloqueio de Objetos com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) na *Referência de API do Amazon S3*.

Consulte um cenário interativo que demonstra os diferentes recursos do Bloqueio de Objetos usando os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) na *Referência de API do Amazon S3*.

Consulte informações gerais sobre como usar diferentes SDKs da AWS em [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) na *Referência de API do Amazon S3*.

## Habilitar a funcionalidade Bloqueio de Objetos em um bucket do S3 existente
<a name="object-lock-configure-existing-bucket"></a>

Você pode habilitar a funcionalidade Bloqueio de Objetos para um bucket do S3 existente usando o console do Amazon S3, a AWS CLI, os AWS SDKs ou a API REST do Amazon S3.

### Usar o console do S3
<a name="object-lock-existing-bucket-console"></a>

**nota**  
A funcionalidade Bloqueio de Objetos só funciona em buckets com versionamento.

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets**.

1. Na lista **Buckets**, escolha o nome do bucket para o qual você deseja habilitar a funcionalidade Bloqueio de Objetos.

1. Escolha a guia **Properties (Propriedades)**.

1. Em **Propriedades**, role para baixo até a seção **Bloqueio de objeto** e escolha **Editar**.

1. Em **Bloqueio de objeto**, escolha **Habilitar**.

   Você deve reconhecer que a ativação da funcionalidade Bloqueio de Objetos permitirá permanentemente que os objetos desse bucket sejam bloqueados.

1. Escolha **Salvar alterações**.



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

O seguinte exemplo de comando `put-object-lock-configuration` define um período de retenção de 50 dias da funcionalidade Bloqueio de Objetos em um bucket chamado `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 obter mais informações e exemplos, 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) na *Referência de comandos da AWS CLI*.

**nota**  
Você pode executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode inicializar diretamente do Console de gerenciamento da AWS. Para obter mais informações, consulte [What is CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) no *Guia do usuário do AWS CloudShell*.

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

Você pode usar a API REST do Amazon S3 para habilitar a funcionalidade Bloqueio de Objetos em um bucket do S3 existente. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html) na *Referência da API do Amazon Simple Storage Service*.

### Usar SDKs da AWS
<a name="object-lock-existing-bucket-sdk"></a>

Consulte exemplos de como habilitar o Bloqueio de Objetos para um bucket existente do S3 com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectLockConfiguration_section.html) na *Referência de API do Amazon S3*.

Consulte exemplos de como obter a configuração atual do Bloqueio de Objetos com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) na *Referência de API do Amazon S3*.

Consulte um cenário interativo que demonstra os diferentes recursos do Bloqueio de Objetos usando os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) na *Referência de API do Amazon S3*.

Consulte informações gerais sobre como usar diferentes SDKs da AWS em [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) na *Referência de API do Amazon S3*.

## Definir ou modificar uma retenção jurídica em um objeto do S3
<a name="object-lock-configure-set-legal-hold"></a>

Você pode definir ou remover uma retenção jurídica de um objeto do S3 usando o console do Amazon S3, a AWS CLI, os AWS SDKs ou a API REST do Amazon S3.

**Importante**  
Se você quiser definir uma retenção jurídica em um objeto, o bucket do objeto já deverá ter a funcionalidade Bloqueio de Objetos habilitada.
Quando você usa `PUT` em uma versão de objeto que tem um modo e um período de retenção individual explícitos em um bucket, as configurações individuais da funcionalidade Bloqueio de Objetos da versão do objeto substituem qualquer configuração de retenção de propriedades do bucket.

Para obter mais informações, consulte [Retenções legais](object-lock.md#object-lock-legal-holds).

### Usar o console do S3
<a name="object-lock-set-legal-hold-console"></a>

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets**.

1. Na lista **Buckets**, escolha o nome do bucket que contém o objeto no qual você deseja definir ou modificar uma retenção jurídica.

1. Na lista **Objetos**, selecione o objeto no qual você deseja definir ou modificar uma retenção jurídica.

1. Na página **Propriedades do objeto**, encontre a seção **Retenção jurídica do Bloqueio de objeto** e escolha **Editar**.

1. Escolha **Habilitar** para definir uma retenção jurídica ou **Desabilitar** para remover uma retenção jurídica.

1. Escolha **Salvar alterações**.

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

O seguinte exemplo de `put-object-legal-hold` define uma retenção jurídica no objeto *`my-image.fs`* no bucket chamado `amzn-s3-demo-bucket1`:

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

O seguinte exemplo de `put-object-legal-hold` remove uma retenção jurídica do objeto *`my-image.fs`* no bucket chamado `amzn-s3-demo-bucket1`:

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

Para obter mais informações e exemplos, 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) na *Referência de comandos da AWS CLI*.

**nota**  
Você pode executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode inicializar diretamente do Console de gerenciamento da AWS. Para obter mais informações, consulte [What is CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) no *Guia do usuário do AWS CloudShell*.

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

É possível usar a API REST para definir ou modificar uma retenção jurídica em um objeto. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLegalHold.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLegalHold.html) na *Referência da API do Amazon Simple Storage Service*.

### Usar SDKs da AWS
<a name="object-lock-set-legal-hold-sdk"></a>

Consulte exemplos de como definir uma retenção legal em um objeto com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectLegalHold_section.html) na *Referência de API do Amazon S3*.

Consulte exemplos de como obter o status de retenção legal atual com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLegalHoldConfiguration_section.html) na *Referência de API do Amazon S3*.

Consulte um cenário interativo que demonstra os diferentes recursos do Bloqueio de Objetos usando os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) na *Referência de API do Amazon S3*.

Consulte informações gerais sobre como usar diferentes SDKs da AWS em [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) na *Referência de API do Amazon S3*.

## Definir ou modificar um período de retenção em um objeto do S3
<a name="object-lock-configure-set-retention-period-object"></a>

Você pode definir ou modificar um período de retenção em um objeto do S3 usando o console do Amazon S3, a AWS CLI, os AWS SDKs ou a API REST do Amazon S3.

**Importante**  
Se você quiser definir um período de retenção em um objeto, o bucket do objeto já deverá ter a funcionalidade Bloqueio de Objetos habilitada.
Quando você usa `PUT` em uma versão de objeto que tem um modo e um período de retenção individual explícitos em um bucket, as configurações individuais da funcionalidade Bloqueio de Objetos da versão do objeto substituem qualquer configuração de retenção de propriedades do bucket.
A única maneira de excluir um objeto no modo de conformidade antes da data de retenção é excluir a Conta da AWS associada.

Para obter mais informações, consulte [Períodos de retenção](object-lock.md#object-lock-retention-periods).

### Usar o console do S3
<a name="object-lock-set-retention-period-console"></a>

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets**.

1. Na lista **Buckets**, escolha o nome do bucket que contém o objeto no qual você deseja definir ou modificar um período de retenção.

1. Na lista **Objetos**, selecione o objeto no qual você deseja definir ou modificar um período de retenção.

1. Na página **Propriedades do objeto**, encontre a seção **Retenção de Bloqueio de objetos** e escolha **Editar**.

1. Em **Retenção**, escolha **Habilitar** para definir um período de retenção ou **Desabilitar** para remover um período de retenção.

1. Se você escolher **Habilitar**, em **Modo de retenção**, escolha o **Modo de governança** ou o **Modo de conformidade**. Para obter mais informações, consulte [Modos de retenção](object-lock.md#object-lock-retention-modes).

1. Em **Prazo de retenção**, escolha a data em que deseja que o período de retenção termine. Durante esse período, o objeto será protegido por WORM e não poderá ser substituído nem excluído. Para obter mais informações, consulte [Períodos de retenção](object-lock.md#object-lock-retention-periods).

1. Selecione **Save changes**.

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

O seguinte exemplo de `put-object-retention` define um período de retenção no objeto *`my-image.fs`* no bucket chamado `amzn-s3-demo-bucket1` até 1.º de janeiro 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 obter mais informações e exemplos, 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) na *Referência de comandos da AWS CLI*.

**nota**  
Você pode executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode inicializar diretamente do Console de gerenciamento da AWS. Para obter mais informações, consulte [What is CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) no *Guia do usuário do AWS CloudShell*.

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

É possível usar a API REST para definir um período de retenção em um objeto. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectRetention.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectRetention.html) na *Referência da API do Amazon Simple Storage Service*.

### Usar SDKs da AWS
<a name="object-lock-set-retention-period-sdk"></a>

Consulte exemplos de como definir um período de retenção em um objeto com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectRetention_section.html) na *Referência de API do Amazon S3*.

Consulte exemplos de como obter o período de retenção em um objeto com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) na *Referência de API do Amazon S3*.

Consulte um cenário interativo que demonstra os diferentes recursos do Bloqueio de Objetos usando os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObjectLockConfiguration_section.html) na *Referência de API do Amazon S3*.

Consulte informações gerais sobre como usar diferentes SDKs da AWS em [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) na *Referência de API do Amazon S3*.

## Definir ou modificar um período de retenção padrão em um bucket do S3
<a name="object-lock-configure-set-retention-period-bucket"></a>

Você pode definir ou modificar um período de retenção padrão em um bucket do S3 usando o console do Amazon S3, a AWS CLI, os AWS SDKs ou a API REST do Amazon S3. Especifique uma duração, em dias ou anos, para proteger cada versão do objeto colocada no bucket.

**Importante**  
Se você quiser definir um período de retenção padrão em um bucket, o bucket já deverá ter a funcionalidade Bloqueio de Objetos habilitada.
Quando você usa `PUT` em uma versão de objeto que tem um modo e um período de retenção individual explícitos em um bucket, as configurações individuais da funcionalidade Bloqueio de Objetos da versão do objeto substituem qualquer configuração de retenção de propriedades do bucket.
A única maneira de excluir um objeto no modo de conformidade antes da data de retenção é excluir a Conta da AWS associada.

Para obter mais informações, consulte [Períodos de retenção](object-lock.md#object-lock-retention-periods).

### Usar o console do S3
<a name="object-lock-set-retention-period-bucket-console"></a>

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets**.

1. Na lista **Buckets**, escolha o nome do bucket no qual você deseja definir ou modificar um período de retenção padrão.

1. Escolha a guia **Properties (Propriedades)**.

1. Em **Propriedades**, role para baixo até a seção **Bloqueio de objeto** e escolha **Editar**.

1. Em **Retenção padrão**, escolha **Habilitar** para definir uma retenção padrão ou **Desabilitar** para remover uma retenção padrão.

1. Se você escolher **Habilitar**, em **Modo de retenção**, escolha o **Modo de governança** ou o **Modo de conformidade**. Para obter mais informações, consulte [Modos de retenção](object-lock.md#object-lock-retention-modes).

1. Em **Período de retenção padrão**, escolha o número de dias ou anos para a duração do período de retenção. Os objetos colocados nesse bucket ficarão bloqueados durante esse número de dias ou anos. Para obter mais informações, consulte [Períodos de retenção](object-lock.md#object-lock-retention-periods).

1. Selecione **Save changes**.

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

O seguinte exemplo de comando `put-object-lock-configuration` define um período de retenção de 50 dias da funcionalidade Bloqueio de Objetos no bucket chamado `amzn-s3-demo-bucket1` usando o modo de conformidade:

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

O seguinte exemplo de `put-object-lock-configuration` remove a configuração de retenção padrão de um bucket:

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

Para obter mais informações e exemplos, 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) na *Referência de comandos da AWS CLI*.

**nota**  
Você pode executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode inicializar diretamente do Console de gerenciamento da AWS. Para obter mais informações, consulte [What is CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) no *Guia do usuário do AWS CloudShell*.

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

É possível usar a API REST para definir um período de retenção padrão em um bucket do S3 disponível. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html) na *Referência da API do Amazon Simple Storage Service*.

### Usar SDKs da AWS
<a name="object-lock-configure-set-retention-period-bucket-sdk"></a>

Consulte exemplos de como definir um período de retenção padrão em um bucket existente do S3 com os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObjectLockConfiguration_section.html) na *Referência de API do Amazon S3*.

Consulte um cenário interativo que demonstra os diferentes recursos do Bloqueio de Objetos usando os SDKs da AWS em [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ObjectLock_section.html) na *Referência de API do Amazon S3*.

Consulte informações gerais sobre como usar diferentes SDKs da AWS em [Developing with Amazon S3 using the AWS SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) na *Referência de API do Amazon S3*.