Identificativi risorsa

Questo argomento descrive i diversi modi in cui vengono identificate le risorse Oracle Cloud Infrastructure.

ID Oracle Cloud (OCID)

La maggior parte dei tipi di risorse Oracle Cloud Infrastructure ha un ID univoco assegnato da Oracle chiamato Oracle Cloud Identifier (OCID). È incluso come parte delle informazioni della risorsa sia nella console che nell'API.

Importante

Per utilizzare l'API, è necessario l'OCID per la tenancy . Per informazioni su dove trovarlo, vedere la sezione successiva.

Gli OCID utilizzano la sintassi seguente:

ocid1.<RESOURCE TYPE>.<REALM>.[REGION][.FUTURE USE].<UNIQUE ID>
  • ocid1: la stringa letterale che indica la versione dell'OCID.
  • tipo di risorsa: il tipo di risorsa (ad esempio, instance, volume, vcn, subnet, user, group e così via).
  • realm: il realm in cui si trova la risorsa. Un realm è un set di aree che condividono entità. I valori possibili sono oc1 per il realm commerciale, oc2 per il realm cloud governativo o oc3 per il realm cloud del governo federale. Le aree del realm commerciale (OC1) appartengono al dominio oraclecloud.com. Le region di Government Cloud (OC2) appartengono al dominio oraclegovcloud.com.
  • regione: l'area in cui si trova la risorsa (ad esempio, phx, iad, eu-frankfurt-1). Con l'introduzione della regione di Francoforte, il formato è passato da un codice di tre caratteri a una stringa più lunga. Questa parte è presente nell'OCID solo per le risorse regionali o quelle specifiche di un singolo dominio di disponibilità. Se l'area non è applicabile alla risorsa, questa parte potrebbe essere vuota (vedere l'ID tenancy di esempio riportato di seguito).
  • uso futuro: riservato per uso futuro. Attualmente vuoto.
  • ID univoco: la parte univoca dell'ID. Il formato può variare a seconda del tipo di risorsa o servizio.

OCID di esempio

Tenancy:

ocid1.tenancy.oc1..aaaaaaaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdsq

Istanza:

ocid1.instance.oc1.phx.abuw4ljrlsfiqw6vzzxb43vyypt4pkodawglp3wqxjqofakrwvou52gb6s5a

Dove trovare l'OCID della tenancy

Se utilizzi l'API di Oracle Cloud Infrastructure, hai bisogno dell'OCID della tua tenancy per firmare le richieste API. Inoltre, è possibile utilizzare l'ID tenancy in alcune operazioni dell'API IAM.

Ottenere l'OCID tenancy dalla console di Oracle Cloud nella pagina Dettagli tenancy:

  1. Nel menu di navigazione selezionare il menu Profilo Icona menu Profilo, quindi selezionare Tenancy: <your_tenancy_name>.

  2. L'OCID tenancy viene visualizzato in Informazioni sulla tenancy. Selezionare Mostra per visualizzare l'intero ID oppure selezionare Copia per copiarlo negli Appunti.

    Pagina Dettagli della tenancy che mostra la posizione dell'OCID tenancy

L'OCID tenancy è simile al seguente (si noti la parola "tenancy" in esso contenuta):

ocid1.tenancy.oc1..<unique_ID>

Nome e descrizione

Il servizio IAM richiede l'assegnazione di un nome univoco e immodificabile a ciascuna risorsa IAM (utenti, gruppi, gruppi dinamici, federazioni e criteri). Il nome deve essere univoco nell'ambito del tipo di risorsa (ad esempio, è possibile avere un solo utente con il nome BobSmith). Tenere presente che questo requisito è specifico di IAM, ma si applica anche ad altri servizi. La maggior parte dei servizi consente di assegnare un nome visualizzato facoltativo.

Il nome assegnato a un utente alla creazione corrisponde alle credenziali di login per la console.

È possibile utilizzare questi nomi al posto dell'OCID durante la scrittura di un criterio (ad esempio, Allow group <GROUP NAME> to manage all-resources in compartment <COMPARTMENT NAME>).

Oltre al nome, è necessario assegnare una descrizione a ciascuna risorsa IAM (anche se può essere una stringa vuota). Può essere una descrizione amichevole o altre informazioni che ti aiutano a identificare facilmente la risorsa. La descrizione non deve essere unica e puoi cambiarla ogni volta che vuoi. Ad esempio, è possibile utilizzare la descrizione per memorizzare l'indirizzo e-mail dell'utente se non si sta già utilizzando l'indirizzo e-mail come nome univoco dell'utente.

Nome visualizzato

Per la maggior parte delle risorse Oracle Cloud Infrastructure create (diverse da quelle in IAM e altri servizi che richiedono alle risorse di avere un nome e una descrizione univoci e immutabili), puoi facoltativamente assegnare un nome di visualizzazione. Può essere una descrizione amichevole o altre informazioni che ti aiutano a identificare facilmente la risorsa. Il nome visualizzato non deve essere univoco e può essere modificato ogni volta che lo si desidera. La console mostra il nome visualizzato della risorsa insieme al relativo OCID.

Attenzione

Evita di inserire informazioni riservate quando assegni descrizioni, tag o nomi descrittivi alle risorse cloud tramite la console, l'API o l'interfaccia CLI di Oracle Cloud Infrastructure.