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 pela Oracle chamado OCID (Oracle Cloud Identifier). Ele é fornecido 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 recurso: O tipo de recurso (por exemplo, instance, volume, vcn, subnet, user, group e assim por diante).
  • 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 do Setor Governamental ou oc3 para o realm Cloud do Setor Governamental Federal. As regiões do realm comercial (OC1) pertencem ao domínio oraclecloud.com. As regiões do Cloud do Setor Governamental (OC2) pertencem ao domínio oraclegovcloud.com.
  • region: A região em que o recurso está (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 está presente no OCID apenas para recursos regionais ou específicos de um único domínio de 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ê usa a API do Oracle Cloud Infrastructure, precisará do OCID da sua tenancy para assinar as solicitações de API. Você também usa o ID da tenancy em algumas das operações da API do IAM.

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

  1. Selecione o menu Perfil (Ícone do menu Perfil), que está no lado superior direito da barra de navegação na parte superior da página, e clique em Tenancy: <your_tenancy_name>.

  2. O OCID da tenancy é mostrado em Informações da Tenancy. Clique em Mostrar para exibir o ID inteiro ou clique em Copiar para copiá-lo para a á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 requer que você designe um nome exclusivo e inalterável para cada um dos seus recursos 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 é o log-in dele para a 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 designar uma descrição a cada um dos recursos 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

Para a maioria dos recursos do Oracle Cloud Infrastructure que você cria (diferentes daqueles do serviço IAM e outros serviços que exigem que os recursos tenham um nome exclusivo, inalterável e uma descrição), opcionalmente você pode designar um nome para exibiçã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 designar descrições, tags ou nomes amigáveis aos recursos na nuvem por meio da Console, API ou CLI do Oracle Cloud Infrastructure.