O Object Storage Service (OSS) permite suspender o versionamento de um bucket para impedir a geração de novas versões dos objetos nele contidos. Com o versionamento suspenso, você pode fazer upload de objetos e baixe ou exclua versões anteriores ao especifique os respectivos IDs de versão.
Fazer upload de objetos
Ao enviar um objeto para um bucket com versionamento suspenso, o OSS o armazena como uma versão com ID nulo. Cada objeto nesse tipo de bucket possui apenas uma versão com ID nulo.
Na figura a seguir, ao usar a operação PutObject para enviar um objeto a um bucket com versionamento suspenso, o OSS armazena esse objeto como uma versão com ID nulo.
No exemplo abaixo, o objeto example.jpg em um bucket com versionamento suspenso possui uma versão com ID 111111. Se você usar a operação PutObject para enviar um objeto com o mesmo nome, o OSS armazenará o novo envio como a versão atual de example.jpg e atribuirá o ID nulo a ela. A versão 111111 será preservada como uma versão anterior.
Conforme ilustrado a seguir, se o objeto example.jpg já tiver uma versão com ID nulo no bucket com versionamento suspenso, o uso da operação PutObject para enviar um arquivo de mesmo nome sobrescreverá a versão nula existente.
Para fazer upload de objetos em buckets com versionamento suspenso, use o comando cp (upload objects) do ossutil ou um dos seguintes SDKs do OSS: OSS SDK for Java, OSS SDK for PHP, OSS SDK for Node.js, OSS SDK for Python,OSS SDK for .NET, OSS SDK for Go e OSS SDK for C++.
Baixe objetos
O OSS permite baixar a versão atual ou uma versão específica de um objeto armazenado em um bucket com versionamento suspenso.
Os exemplos a seguir demonstram o comportamento do download via GetObject em buckets com versionamento suspenso, com e sem a especificação do ID de versão:
Por padrão, caso nenhum ID de versão seja informado na requisição, o sistema retorna a versão atual do objeto. Na imagem abaixo, a versão retornada é a atual, cujo ID é nulo.
-
Quando você especifique um ID de versão na requisição GetObject, o OSS retorna exatamente essa versão. O exemplo visual a seguir mostra o retorno da versão com ID 222222.
Para baixe objetos de buckets com versionamento suspenso, use o comando cp (download objects) do ossutil ou os SDKs listados abaixo: OSS SDK for Java, OSS SDK for PHP, OSS SDK for Node.js, OSS SDK for Python,OSS SDK for .NET, OSS SDK for Go e OSS SDK for C++.
Exclua objetos
Veja a seguir como funciona a exclusão de objetos em diferentes cenários dentro de um bucket com versionamento suspenso:
Se você usar a operação DeleteObject em um objeto cuja versão atual possui ID diferente de nulo, o OSS insere um marcador de exclusão (delete marker) com ID nulo, que passa a ser a versão atual.
Caso a versão atual do objeto já tenha ID nulo, a operação DeleteObject adiciona um novo marcador de exclusão com ID nulo como versão atual. Como cada objeto só pode ter uma versão nula, o marcador recém-adicionado sobrescreve a versão nula anterior.
Especifique um ID de versão na requisição DeleteObject resulta na exclusão permanente daquela versão específica. Na figura seguinte, a versão com ID 333333 foi removida definitivamente.
Para exclua objetos em buckets com versionamento suspenso, use o comando rm do ossutil ou os seguintes SDKs do OSS: OSS SDK for Java, OSS SDK for PHP, OSS SDK for Node.js, OSS SDK for Python,OSS SDK for .NET, OSS SDK for Go e OSS SDK for C++.