Recuperando versões de objeto de um bucket habilitado para versionamento - Amazon Simple Storage Service

Recuperando versões de objeto de um bucket habilitado para versionamento

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.

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.

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.

  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. Na lista Buckets, escolha o nome do bucket que contém o objeto.

  3. Na lista Objetos , escolha o nome do objeto.

  4. Escolha Versões.

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

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

  6. Escolha Ações, escolha Downloade 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.

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.

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.

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.

Para recuperar uma versão específica do objeto

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

  2. Envie uma solicitação GET Object versionId.

exemplo — Recuperar um objeto versionado

A seguinte solicitação recupera a versão L4kqtJlcpXroDTDmpUMLUo do my-image.jpg.

GET /my-image.jpg?versionId=L4kqtJlcpXroDTDmpUMLUo HTTP/1.1
Host: bucket.s3.amazonaws.com
Date: Wed, 28 Oct 2009 22:32:00 GMT
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.

Para obter informações sobre como restaurar uma versão de objeto anterior, consulte Restaurar versões anteriores.