Object Storage Service:bucket-versioning

Notas de uso

• Para configure o versionamento, você precisa ter a permissão oss:PutBucketVersioning. Para consultar o status do versionamento, você precisa ter a permissão oss:GetBucketVersioning. Para mais informações, consulte Grant a custom policy.

• No ossutil 1.6.16 e versões posteriores, você pode usar ossutil diretamente como nome do binário na linha de comando, sem precisar atualizá-lo com base no sistema operacional. Em versões anteriores à 1.6.16, atualize o nome do binário conforme o sistema operacional. Para mais informações, consulte ossutil command reference.

• Para mais informações sobre versionamento, consulte Versioning.

Configurar o versionamento

• Sintaxe do comando

  ossutil bucket-versioning --method put oss://bucketname versioning

  A tabela a seguir descreve os parâmetros da sintaxe do comando.

  Parameter	Description
  bucketname	O nome do bucket para o qual você deseja configure o versionamento.
  versioning	O status de versionamento do bucket. Valores válidos: enabled: ative o versionamento para o bucket. Ao fazer upload de um objeto para um bucket com versionamento ativo, o OSS gera uma string aleatória como ID de versão globalmente único do objeto. Para mais informações, consulte Manage versioned objects. suspended: suspende o versionamento do bucket. Ao fazer upload de um objeto para um bucket com versionamento suspenso, o OSS gera um ID de versão null para o objeto carregado. Para mais informações, consulte Manage objects in a versioning-suspended bucket. Importante Por padrão, o status de versionamento de um bucket é sem versão (unversioned). Após ativar o versionamento, não é possível reverter o status do bucket para sem versão. No entanto, você pode suspender o versionamento de um bucket com versionamento ativo.

• Exemplos

  Execute o seguinte comando para ativar o versionamento em um bucket chamado examplebucket:

  ossutil bucket-versioning --method put oss://examplebucket enabled

  Execute o seguinte comando para suspender o versionamento em um bucket chamado examplebucket:

  ossutil bucket-versioning --method put oss://examplebucket suspended

  O exemplo de saída a seguir indica que o versionamento foi configurado para o bucket:

  0.261209(s) elapsed

Consultar o status de versionamento de um bucket

• Sintaxe do comando

  ossutil bucket-versioning --method get oss://bucketname

• Exemplos

  Execute o seguinte comando para consultar o status de versionamento de um bucket chamado examplebucket:

  ossutil bucket-versioning --method get oss://examplebucket

  O exemplo de saída a seguir indica que o versionamento está ativo para o bucket:

  bucket versioning status:Enabled
  
  0.218001(s) elapsed

  O exemplo de saída a seguir indica que o versionamento está suspenso para o bucket:

  bucket versioning status:Suspended
  
  0.168791(s) elapsed

  O exemplo de saída a seguir indica que o status de versionamento é sem versão (unversioned):

  bucket versioning status:Null
  
  0.158691(s) elapsed

Operações relacionadas

• O upload para um bucket com versionamento ativo funciona da mesma forma que o upload para um bucket sem versão, com a diferença de que o OSS gera um ID de versão globalmente único para cada objeto carregado. Para mais informações, consulte cp (upload files).

• Após ativar o versionamento em um bucket, os objetos sobrescritos ou excluídos são preservados como versões anteriores. Especifique um ID de versão para baixe a versão desejada de um objeto — para mais informações, consulte cp (Download objects). Você também pode especifique um ID de versão para restaurar uma versão anterior específica de um objeto — para mais informações, consulte Copy objects using the cp command.

Opções comuns

Para acessar um bucket em uma região diferente, use -e para especifique o endpoint. Para acessar um bucket de outra conta da Alibaba Cloud, use -i para informar o AccessKey ID e -k para o AccessKey secret.

ossutil bucket-versioning--method put oss://examplebucket enabled -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.