Identificadores de Recursos

Este tópico descreve as diferentes formas pelas quais os recursos do Oracle Cloud Infrastructure são identificados.

Oracle Cloud IDs (OCIDs)

A maioria dos tipos de recursos do Oracle Cloud Infrastructure tem um ID exclusivo designado pelo sistema Oracle chamado Oracle Cloud Identifier (OCID). Ele é incluído como parte das informações do recurso na Console e na API.

Importante

Para usar a API, você precisa do OCID para sua tenancy . Para obter informações sobre onde encontrá-lo, consulte a próxima seção.

Os OCIDs usam esta sintaxe:

ocid1.<RESOURCE TYPE>.<REALM>.[REGION][.FUTURE USE].<UNIQUE ID>
  • ocid1: A string literal que indica a versão do OCID.
  • tipo de recursos: O tipo de recursos (por exemplo, instance, volume, vcn, subnet, user, group, etc.).
  • realm: O realm no qual o recurso está. Um realm é um conjunto de regiões que compartilham entidades. Os valores possíveis são oc1 para o realm comercial, oc2 para o realm do Cloud Governamental ou oc3 para o realm do Cloud Federal do Governo. As regiões do realm comercial (OC1) pertencem ao domínio oraclecloud.com. As regiões no Cloud do Governo (OC2) pertencem ao domínio oraclegovcloud.com.
  • região: A região em que o recurso se encontra (por exemplo, phx, iad, eu-frankfurt-1). Com a introdução da região Frankfurt, o formato passou de um código de três caracteres para uma string mais longa. Esta parte só está presente no OCID para recursos regionais ou específicos para um único domínio da disponibilidade. Se a região não for aplicável ao recurso, essa parte poderá ficar em branco (consulte o ID da tenancy de exemplo abaixo).
  • uso futuro: Reservado para uso futuro. Em branco no momento.
  • ID exclusivo: A parte exclusiva do ID. O formato pode variar dependendo do tipo de recurso ou serviço.

OCIDs de Exemplo

Tenancy:

ocid1.tenancy.oc1..aaaaaaaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdsq

Instância:

ocid1.instance.oc1.phx.abuw4ljrlsfiqw6vzzxb43vyypt4pkodawglp3wqxjqofakrwvou52gb6s5a

Onde Encontrar o OCID de sua Tenancy

Se você usar a API do Oracle Cloud Infrastructure, precisará do OCID da sua tenancy para assinar as solicitações da API. Você também usa o ID da tenancy em algumas operações da API do serviço IAM.

Obtenha o OCID da tenancy da Console do Oracle Cloud na página Detalhes da Tenancy:

  1. No menu de navegação, selecione o menu Perfil Ícone do menu Perfil e selecione Tenancy: <your_tenancy_name>.

  2. O OCID da tenancy é mostrado em Informações da Tenancy. Selecione Mostrar para exibir o ID inteiro ou selecione Copiar para copiá-lo para a sua área de transferência.

    Página Detalhes da Tenancy mostrando o local do OCID da tenancy

O OCID da tenancy tem uma aparência semelhante a esta (observe a palavra "tenancy" nele):

ocid1.tenancy.oc1..<unique_ID>

Nome e Descrição

O serviço IAM exige que você designe um nome exclusivo e inalterável a cada recurso do IAM (usuários, grupos, grupos dinâmicos, federações e políticas). O nome deve ser exclusivo dentro do escopo do tipo de recurso (por exemplo, você só pode ter um usuário com o nome BobSmith). Observe que esse requisito é específico para o IAM, mas também se aplica a alguns outros serviços. (A maioria dos serviços permite que você designe um nome para exibição opcional.)

O nome que você designa a um usuário na criação é seu log-in na Console.

Você pode usar esses nomes em vez do OCID ao gravar uma política (por exemplo, Allow group <GROUP NAME> to manage all-resources in compartment <COMPARTMENT NAME>).

Além do nome, você também deve atribuir uma descrição a cada recurso do IAM (embora possa ser uma string vazia). Pode ser uma descrição amigável ou outras informações que o ajude a identificar facilmente o recurso. A descrição não precisa ser exclusiva e você pode alterá-la sempre que desejar. Por exemplo, talvez você queira usar a descrição para armazenar o endereço de e-mail do usuário se ainda não estiver usando o endereço de e-mail como o nome exclusivo do usuário.

Nome para Exibição

Na maioria dos recursos do Oracle Cloud Infrastructure que você cria (exceto os do IAM e outros serviços que exigem que os recursos tenham um nome exclusivo e imutável e uma descrição), você pode designar um nome para visualização. Pode ser uma descrição amigável ou outras informações que o ajude a identificar facilmente o recurso. O nome para exibição não precisa ser exclusivo e você pode alterá-lo sempre que desejar. A Console mostra o nome para exibição do recurso juntamente com seu OCID.

Cuidado

Evite inserir informações confidenciais ao atribuir descrições, tags ou nomes amigáveis aos recursos de nuvem por meio da Console, API ou CLI do Oracle Cloud Infrastructure.