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 de lista Buckets, selecione o bucket do serviço Object Storage com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou o bucket, consulte Listando Buckets.
    2. Na página de detalhes do bucket, selecione Objetos.
      A guia Objetos é aberta. Todos os objetos no bucket selecionado são exibidos em uma tabela.
    3. No menu Ações do objeto desejado, selecione Renomear.
      O painel Renomear objeto é aberto.
    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 inserir informações confidenciais.
      Cuidado

      Buckets não podem armazenar dois objetos que usam nomes idênticos (diferenciação de maiúsculas e minúsculas). Se você renomear um objeto usando o nome de outro objeto no mesmo bucket, o objeto que usou originalmente o nome será substituído.
    5. Selecione Atualizar.

  • 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"
}

    Para ver uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Comando CLI.

    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 *

  • 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.