

# Recuperando versões de objeto de um bucket habilitado para versionamento
<a name="RetrievingObjectVersions"></a>

O versionamento no Amazon S3 é uma maneira de manter várias variantes de um objeto no mesmo bucket. Uma solicitação `GET` simples recupera a versão atual de um objeto. A figura a seguir mostra como o `GET` retorna a versão atual do objeto, `photo.gif`.

![Ilustração de como GET retorna a versão atual do objeto.](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/versioning_GET_NoVersionID.png)


Para recuperar uma versão específica, você tem que especificar seu ID de versão. A figura a seguir mostra que a solicitação `GET versionId` recupera a versão especificada do objeto (não necessariamente a versão atual).

![Ilustração de como a solicitação GET versionId recupera a versão especificada do objeto.](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/versioning_GET_Versioned.png)


Você pode recuperar versões de objeto no Amazon S3 usando o console, os AWS SDKs ou a API REST.

**nota**  
 Para acessar versões de objetos anteriores a 300 versões, use a AWS CLI ou o URL do objeto.

## Usar o console do S3
<a name="retrieving-object-versions"></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. Na lista **Buckets**, escolha o nome do bucket que contém o objeto.

1. Na lista **Objetos** , escolha o nome do objeto.

1. Escolha **Versões**.

   O Amazon S3 mostra todas as versões do objeto.

1. Marque a caixa de seleção ao lado **do ID da versão** para as versões que deseja recuperar.

1. Escolha **Ações**, escolha **Download**e salve o objeto.

Você também pode visualizar, fazer download e excluir versões do objeto no painel de visão geral do objeto. Para ter mais informações, consulte [Exibir propriedades do objeto no console do Amazon S3](view-object-properties.md).

**Importante**  
Você pode cancelar a exclusão de um objeto somente se ele foi excluído como a versão mais recente (atual). Não é possível cancelar a exclusão de uma versão anterior de um objeto que foi excluído. Para obter mais informações, consulte [Reter várias versões de objetos com o Versionamento do S3](Versioning.md).

## Uso da SDKs AWS
<a name="retrieve-obj-version-sdks"></a>

Os exemplos para carregar objetos em buckets não versionados e habilitados para versionamento são os mesmos. No entanto, para buckets habilitados para versionamento, o Amazon S3 atribui um número de versão. Caso contrário, o número de versão é nulo.

Para obter exemplos de download de objetos usando AWS SDKs for Java, .NET e PHP, consulte [Download de objetos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html).

Para obter exemplos de como listar a versão de objetos usando AWS SDKs para.NET e Rust, consulte [Listar a versão dos objetos em um bucket do Amazon S3](https://docs.aws.amazon.com/code-library/latest/ug/s3_example_s3_ListObjectVersions_section.html).

## Uso da API REST
<a name="retrieve-obj-version-rest"></a>

**Para recuperar uma versão específica do objeto**

1. Defina `versionId` como o ID da versão do objeto que você deseja recuperar.

1. Envie uma solicitação `GET Object versionId`.

**Example — Recuperar um objeto versionado**  
A seguinte solicitação recupera a versão `L4kqtJlcpXroDTDmpUMLUo` do `my-image.jpg`.  

```
1. GET /my-image.jpg?versionId=L4kqtJlcpXroDTDmpUMLUo HTTP/1.1
2. Host: bucket.s3.amazonaws.com
3. Date: Wed, 28 Oct 2009 22:32:00 GMT
4. Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
```

Você pode recuperar apenas os metadados de um objeto (não o conteúdo). Para obter mais informações, consulte [Recuperar metadados de uma versão de objeto](RetMetaOfObjVersion.md).

Para obter informações sobre como restaurar uma versão de objeto anterior, consulte [Restaurar versões anteriores](RestoringPreviousVersions.md).