View a markdown version of this page

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.

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

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.

É possível restaurar uma versão anterior de um objeto usando o console do Amazon S3 ao excluir a versão atual. Com essa exclusão, a versão anterior se torna a nova versão atual.

Para restaurar uma versão anterior excluindo a versão atual

  1. Faça login no Console de gerenciamento da AWS 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 da versão atual (mais recente) que deseja excluir.

  6. Escolha Excluir.

  7. Na caixa de diálogo Excluir objetos, insira permanently delete e escolha Excluir objetos.

    Depois de excluir a versão atual, a versão anterior se torna a versão atual.

Para baixar uma versão anterior

  1. Faça login no Console de gerenciamento da AWS 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 propriedades do objeto no console do Amazon S3.

nota

Para copiar uma versão anterior (tornando-a a nova versão atual), use os SDKs da AWS CLI ou AWS — essa abordagem não está disponível no console do Amazon S3. Para obter um exemplo, consulte a guia AWS CLI.

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.