Identificadores de recurso

En este tema, se describen las distintas formas en que se identifican los recursos de Oracle Cloud Infrastructure.

Oracle Cloud ID (OCID)

La mayoría de los tipos de recursos de Oracle Cloud Infrastructure tienen un ID único asignado por la aplicación Oracle denominado Oracle Cloud Identifier (OCID). Se incluye como parte de la información del recurso tanto en la consola como en la API.

Importante

Para usar la API, necesita el OCID para su arrendamiento. Para obtener información sobre dónde encontrarlo, consulte la siguiente sección.

Los OCID utilizan esta sintaxis:

ocid1.<RESOURCE TYPE>.<REALM>.[REGION][.FUTURE USE].<UNIQUE ID>
  • ocid1: la cadena literal que indica la versión del OCID.
  • resource type: tipo de recurso (por ejemplo, instance, volume, vcn, subnet, user, group, etc.).
  • realm: el dominio en el que está el recurso. Un dominio es un conjunto de regiones que comparten entidades. Los valores posibles son oc1 para el dominio comercial, oc2 para el dominio de Global Cloud del Gobierno o oc3 para el dominio de Federal Government Cloud. Las regiones del dominio comercial (OC1) pertenecen al dominio oraclecloud.com. Las regiones de la nube del Gobierno (OC2) pertenecen al dominio oraclegovcloud.com.
  • region: la región en la que está el recurso (por ejemplo, phx, iad, eu-frankfurt-1). Con la introducción de la región de Fráncfort, el formato ha pasado de ser un código de tres caracteres a una cadena más larga. Esta parte está presente en el OCID solo para recursos regionales o los específicos de un solo dominio de disponibilidad. Si la región no es aplicable al recurso, esta parte puede estar en blanco (consulte el siguiente ID de arrendamiento de ejemplo).
  • future use: reservado para uso futuro. Actualmente en blanco.
  • unique ID: parte única del identificador. El formato puede variar según el tipo de recurso o servicio.

OCID de ejemplo

Arrendamiento:

ocid1.tenancy.oc1..aaaaaaaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdsq

Instancia:

ocid1.instance.oc1.phx.abuw4ljrlsfiqw6vzzxb43vyypt4pkodawglp3wqxjqofakrwvou52gb6s5a

Dónde encontrar el OCID de su arrendamiento

Si utiliza la API de Oracle Cloud Infrastructure, necesita que el OCID de su arrendamiento para firmar las solicitudes de API. También puede utilizar el ID de arrendamiento en algunas de las operaciones de la API deIAM.

Lo puede encontrar el OCID de arrendamiento de la Consola de Oracle Cloud en la página Detalles de arrendamiento:

  1. En el menú de navegación, seleccione el menú Perfil Icono de menú de perfil y, a continuación, seleccione Arrendamiento: <your_tenancy_name>.

  2. El OCID de arrendamiento se muestra en Información de arrendamiento. Seleccione Mostrar para mostrar el identificador completo, o bien en Copiar para copiarlo en el portapapeles.

    Página Detalles de arrendamiento que muestra la ubicación del OCID de arrendamiento

El OCID de arrendamiento tiene un aspecto similar a este (aparece la palabra "tenancy"):

ocid1.tenancy.oc1..<unique_ID>

Nombre y descripción

El servicio IAM requiere que asigne un nombre único no modificable a cada Uno de los recursos de los IAM (usuarios, grupos, grupos dinámicos, federaciones y políticas). El nombre debe ser único dentro del ámbito del tipo de recurso (por ejemplo, solo puede haber un usuario con el nombre BobSmith). Observe que este requisito es específico de IAM, pero también se aplica a otros servicios. (La mayoría de los servicios le permiten asignar un nombre mostrado opcional).

El nombre que asigne a un usuario en la creación es su conexión a la consola.

Puede utilizar estos nombres en lugar del OCID al escribir una política (por ejemplo, Allow group <GROUP NAME> to manage all-resources in compartment <COMPARTMENT NAME>).

Además del nombre, también se debe asignar una descripción a cada uno de los recursos IAM (aunque puede ser una cadena vacía). Puede ser una descripción fácil de recordar o cualquier otra información que le ayude a identificar fácilmente el recurso. La descripción no tiene por qué ser única y puede cambiarla cuando desee. Por ejemplo, tal vez desee utilizar la descripción para almacenar la dirección de correo electrónico del usuario si aún no usa dicha dirección como nombre único del usuario.

Nombre mostrado

Para la mayoría de los recursos de la instancia de Oracle Cloud Infrastructure que cree (excepto los de la instancia de IAM y otros servicios que requieran que las instancias tengan un nombre único e intercambiable y una descripción), puede asignar un nombre visible de manera opcional. Puede ser una descripción fácil de recordar o cualquier otra información que le ayude a identificar fácilmente el recurso. El nombre mostrado no tiene por qué ser único y puede cambiarlo cuando lo desee. La consola muestra el nombre mostrado del recurso junto con su OCID.

Atención

Evite introducir información confidencial al asignar descripciones, etiquetas o nombres fáciles de aprender a recordar a las instancias de la nube mediante la consola, la API o CLI de la Oracle Cloud Infrastructure.