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 Oracle denominado Oracle Cloud Identifier (OCID). Se incluye como parte de la información de los recursos en la consola y 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 Government Cloud o oc3 para el dominio de Government Cloud federal. 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 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 de IAM.

Lo puede encontrar en la consola de Oracle Cloud Infrastructure en la página Detalles de arrendamiento:

  1. Seleccione el menú Perfil (Icono de Menú de Perfil), que se encuentra en la parte superior derecha de la barra de navegación en la parte superior de la página y, a continuación, haga clic en Arrendamiento: <your_tenancy_name>.

  2. El OCID de arrendamiento se muestra en Información de arrendamiento. Haga clic en Mostrar para mostrar el identificador completo, o 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 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). Tenga en cuenta 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 durante 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 debe asignar una descripción a cada uno de los recursos de 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 Oracle Cloud Infrastructure que cree (excepto los de IAM y otros servicios que requieran que los recursos tengan un nombre único e intercambiable y una descripción), puede asignar un nombre mostrado 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 recordar a los recursos de la nube mediante la consola, la API o la CLI de Oracle Cloud Infrastructure.