Adicionar objetos a buckets com versionamento habilitado - Amazon Simple Storage Service

Adicionar objetos a buckets com versionamento habilitado

Depois que você habilita o versionamento em um bucket, o Amazon S3 adiciona automaticamente um ID de versão exclusivo a cada objeto armazenado (usando PUT, POST ou CopyObject) no bucket.

A figura a seguir mostra que o Amazon S3 adiciona um ID de versão exclusivo a um objeto quando ele é adicionado a um bucket com versionamento habilitado.

Ilustração de um ID de versão único adicionado a um objeto quando ele é colocado em um bucket com versionamento habilitado.
nota

Os valores de ID de versão que o Amazon S3 atribui são seguros para URL (podem ser incluídos como parte de um URI).

Para obter mais informações sobre versionamento, consulte Reter várias versões de objetos com o Versionamento do S3. Você pode adicionar versões de objeto a um bucket habilitado para versionamento usando o console, os AWS SDKs e a API REST.

Para obter instruções, consulte Fazer upload de objetos.

Para ver exemplos de upload de objetos usando os AWS SDKs para Java, .NET e PHP, consulte Fazer upload de objetos. Os exemplos de upload de objetos em buckets com e sem versionamento habilitado são os mesmos, embora o Amazon S3 atribua um número de versão para buckets com versionamento habilitado. Caso contrário, o número de versão é nulo.

Para obter informações sobre o uso de outros AWS SDKs, consulte o Centro do Desenvolvedor da AWS.

Para adicionar objetos a buckets com versionamento habilitado
  1. Ative o versionamento de um bucket usando uma solicitação PutBucketVersioning.

    Para obter mais informações, consulte PutBucketVersioning na Referência da API do Amazon Simple Storage Service.

  2. Envie uma solicitação PUT, POST ou CopyObject para armazenar um objeto no bucket.

Quando você adiciona um objeto a um bucket habilitado para versionamento, o Amazon S3 retorna o ID da versão do objeto no cabeçalho de resposta x-amz-version-id, como mostrado no exemplo a seguir.

x-amz-version-id: 3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY