Renomeando um Objeto do Serviço Object Storage
Renomeie um objeto em um bucket do Object Storage.
Para obter informações sobre a nomenclatura de objetos, consulte Nomes de Objetos.
Use o comando oci os object rename e os parâmetros necessários para renomear um objeto em um bucket:
oci os object rename --bucket-name bucket_name --name object_original_name --new-name object_new_name [OPTIONS]
Por exemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt { "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e" }
Renomeando um Objeto com uma Tag de Entidade Específica
Para tornar a operação de renomeação dependente do objeto que tem uma tag de entidade específica, use a opção
--src-obj-if-match-e-tag
.Por exemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --src-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Substituindo um Objeto
Para operações de renomeação nas quais você pretenda substituir um objeto em um bucket por outro, é possível tornar a renomeação dependente do fato de haver uma tag de entidade específica. Para isso, use a opção
--new-obj-if-match-e-tag
.Por exemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Impedindo a Substituição de um Objeto
Ao renomear um objeto, você pode impedir que o sistema substitua outro objeto no mesmo bucket usando a opção
--new-obj-if-none-match-e-tag *
. Essa opção impede a conclusão da operação de renomeação se existir um objeto com o valor--new-name
especificado e com a mesma tag de entidade do objeto de origem.Por exemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-none-match-e-tag *
Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comando da CLI.
Execute a operação RenameObject para renomear um objeto em um bucket.
O serviço Object Storage pré-anexa a string de namespace do Object Storage e o nome do bucket ao nome do objeto ao construir um URL para uso com a API:
/n/object_storage_namespace/b/bucket/o/object_name
O nome do objeto é tudo após
/o/
, o que pode incluir níveis de hierarquia e strings de prefixo.