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.

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).

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 obter mais informações, consulte Exibir uma visão geral 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 Usando o versionamento em buckets 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.