Namespaces do Serviço Object Storage

Saiba como acessar e usar seu namespace para executar tarefas do serviço Object Storage.

O namespace do serviço Object Storage serve como o contêiner de nível superior para todos os buckets e objetos. No momento da criação da conta, cada tenant do Oracle Cloud Infrastructure recebe um nome de namespace exclusivo e imutável do serviço Object Storage gerado pelo sistema. O namespace abrange todos os compartimentos dentro de uma região. Você controla os nomes dos buckets, mas eles devem ser exclusivos em um namespace. Embora o namespace seja específico da região, o próprio nome do namespace é o mesmo em todas as regiões.

Importante

Não é possível personalizar, alterar ou solicitar uma alteração no nome de um namespace.
Dica

Para algumas tenancies mais antigas, a string de nome de namespace pode ser baseada no nome da tenancy, em vez de ser gerada por máquina. Se seu namespace foi criado com base no nome da tenancy, ele usará todas as letras minúsculas (não importando a presença de letras maiúsculas no nome da tenancy). Ao usar a API, a CLI ou SDKs e a CLI, não use letras maiúsculas em sua string de nome de namespace.

Se sua tenancy receber um nome de namespace axaxnpcrorw5, este será seu nome de namespace em todas as regiões. Você pode criar um bucket chamado MyBucket na região Oeste dos EUA (Phoenix). Não é possível criar outro bucket chamado MyBucket na região oeste dos EUA (Phoenix). No entanto, você pode criar um bucket chamado MyBucket na região Central da Alemanha (Frankfurt). Como o nome do namespace é exclusivo de um tenant, outros clientes podem criar buckets denominados MyBucket em seus próprios namespaces.

Dentro de um namespace, existem buckets e objetos em uma hierarquia simples, mas você pode simular uma estrutura de diretório para ajudar a navegar em um grande conjunto de objetos. Consulte Nomeação de Objetos com Prefixos e Hierarquias para obter detalhes.

Os metadados do namespace armazenam as atribuições de compartimento padrão para a API de Compatibilidade com Amazon S3 e a API Swift. Para obter mais informações, consulte Exibindo e Especificando Compartimentos Designados.

  • Para exibir a sua string de namespace do serviço Object Storage, faça o seguinte:

    Abra o menu Perfil e clique em Tenancy: <your_tenancy_name>. Sua string de namespace está listada em Definições do Serviço Object Storage.

    Observação

    Embora a string de namespace do serviço Object Storage seja exibida em Definições do Serviço Object Storage, você não pode editar a string de namespace. A string de namespace aparece aqui apenas para fins informativos.

  • Execute o seguinte comando para obter seu namespace do serviço Object Storage:

    oci os ns get [OPTIONS]

    Seu namespace do serviço Object Storage é retornado:

    
    {
        "data": "MyNamespace"
    }		
    Dica

    Você pode usar -ns, --namespace ou --namespace-name para comandos da CLI que exigem a especificação da string de namespace do serviço Object Storage.

    Para obter informações sobre como usar a CLI, consulte Interface de Linha de Comando (CLI). Para obter uma lista completa de flags e opções disponíveis para comandos da CLI, consulte a Referência da Linha de Comando.

  • Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

    Use a operação GetNamespace para obter seu namespace do serviço Object Storage. Se você tiver a permissão OBJECTSTORAGE_NAMESPACE_READ e fornecer o compartimento ou OCID da tenancy no parâmetro compartmentId opcional, também poderá obter o namespace de outro namespace do serviço Object Storage da tenancy.