

# Gerenciar o versionamento do S3 para um bucket do S3 no Outposts
<a name="S3OutpostsManagingVersioning"></a>

Quando habilitado, o versionamento do S3 salva várias cópias distintas de um objeto no mesmo bucket. O versionamento do S3 pode ser usado para preservar, recuperar e restaurar todas as versões de cada objeto armazenado em buckets do Outposts. O versionamento do S3 ajuda você a se recuperar de ações não intencionais de usuários e de falhas da aplicação. 

Os buckets do Amazon S3 no Outposts têm três estados de versionamento:
+ **Unversioned** (Sem versionamento): se você nunca habilitou ou suspendeu o versionamento do S3 em seu bucket, ele não tem versionamento e não retorna nenhum status de versionamento do S3. Para obter mais informações sobre o S3 Versioning, consulte [Gerenciar o versionamento do S3 para um bucket do S3 no Outposts](#S3OutpostsManagingVersioning).
+ **Enabled** (Habilitado): habilita o versionamento do S3 para os objetos no bucket. Todos os objetos adicionados ao bucket recebem um ID de versão exclusivo. Os objetos que já existiam no bucket no momento em que você habilita o controle de versão têm um ID de versão `null`. Se você modificar esses (ou quaisquer outros) objetos com outras operações, como [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html), os novos objetos receberão um ID de versão exclusivo.
+ **Suspended** (Suspenso): suspende o versionamento do S3 para os objetos no bucket. Todos os objetos adicionados ao bucket depois que o versionamento é suspenso recebem o ID de versão `null`. Consulte mais informações em [Adicionar objetos a buckets com versionamento suspenso](https://docs.aws.amazon.com/AmazonS3/latest/userguide/AddingObjectstoVersionSuspendedBuckets.html) no *Guia do usuário do Amazon S3*.

Depois que você habilita o versionamento do S3 para um bucket do S3 no Outposts, ele nunca pode voltar a um estado sem versionamento. No entanto, você pode suspender o versionamento. Para obter mais informações sobre o S3 Versioning, consulte [Gerenciar o versionamento do S3 para um bucket do S3 no Outposts](#S3OutpostsManagingVersioning).

Para cada objeto em um bucket, há uma versão atual e zero ou mais versões desatualizadas. Para reduzir os custos de armazenamento, você pode configurar regras de ciclo de vida do bucket do S3 para expirar as versões desatualizadas após um período especificado. Para obter mais informações, consulte [Criar e gerenciar uma configuração de ciclo de vida para um bucket do Amazon S3 on Outposts](S3OutpostsLifecycleManaging.md).

Os exemplos a seguir mostram como habilitar ou suspender o versionamento para um bucket do S3 no Outposts usando o Console de gerenciamento da AWS e a AWS Command Line Interface (AWS CLI). Para criar um bucket com versionamento do S3 habilitado, consulte [Criar um bucket do S3 on Outposts](S3OutpostsCreateBucket.md).

**nota**  
A Conta da AWS que cria o bucket é proprietária dele e é a única que pode confirmar suas ações. Os buckets têm propriedades de configuração como Outpost, etiquetas, criptografia padrão e configurações de ponto de acesso. As configurações de ponto de acesso incluem a nuvem privada virtual (VPC), a política do ponto de acesso para acessar os objetos no bucket e outros metadados. Para obter mais informações, consulte [Especificações do Amazon S3 no Outposts](S3OnOutpostsRestrictionsLimitations.md#S3OnOutpostsSpecifications).

## Usar o console do S3
<a name="S3OutpostsVersioningConsole"></a>

**Como editar as configurações de versionamento do S3 para um bucket**

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 **Outposts buckets** (Buckets do Outposts).

1. Escolha o bucket do Outposts para o qual você deseja habilitar o versionamento do S3.

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

1. Em **Bucket Versioning (Versionamento de bucket)**, escolha **Edit (Editar)**.

1. Edite as configurações de versionamento do S3 para o bucket escolhendo uma das seguintes opções:
   + Para suspender o versionamento do S3 e interromper a criação de versões de objetos, escolha **Suspend** (Suspender).
   + Para habilitar o versionamento do S3 e salvar várias cópias distintas de cada objeto, escolha **Enable** (Habilitar).

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

## Como usar o AWS CLI
<a name="S3OutpostsVersioningCLI"></a>

Para habilitar ou suspender o versionamento do S3 para um bucket usando a AWS CLI, use o comando `put-bucket-versioning` conforme mostrado nos exemplos a seguir. Para usar esses exemplos, substitua cada `user input placeholder` por suas próprias informações. 

Para obter mais informações, consulte [put-bucket-versioning](https://docs.aws.amazon.com/cli/latest/reference/s3control/put-bucket-versioning.html) na *Referência da AWS CLI*. 

**Example : Habilitar o versionamento do S3**  

```
aws s3control put-bucket-versioning --account-id 123456789012 --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket --versioning-configuration Status=Enabled
```

**Example : Suspender o versionamento do S3**  

```
aws s3control put-bucket-versioning --account-id 123456789012 --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket --versioning-configuration Status=Suspended
```