Documentação do Oracle Cloud Infrastructure

Renomeando um Objeto do Object Storage

Renomeie um objeto em um bucket do Object Storage.

Para obter informações sobre a nomenclatura de objetos, consulte Nomes de Objetos.

    1. Na página da lista Buckets, selecione o bucket do Object Storage com o qual você deseja trabalhar. Se precisar de ajuda para encontrar a página da lista ou o bucket do Object Storage, consulte Listando Buckets.
    2. Na página de detalhes, selecione Objetos.
    3. No menu Ações do objeto desejado, selecione Renomear.
    4. Informe o novo nome do objeto na caixa Nome do Objeto. Você pode incluir um prefixo de estrutura de diretório delimitado opcional. Por exemplo, p_94.jpg ou /marathon/participants/p_94.jpg. Evite digitar informações confidenciais.
      Cuidado

      Os buckets não podem armazenar dois objetos que usem nomes idênticos (com distinção de maiúsculas e minúsculas). Se você renomear um objeto usando o nome de outro objeto no mesmo bucket, o objeto que originalmente usou o nome será substituído.

    5. Selecione Salvar Alterações.

  • 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 dos parâmetros e valores dos comandos da CLI, consulte a Referência de Comandos 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.