Nomi delle risorse cloud
Un nome di risorsa cloud (CRN) identifica in modo univoco le risorse di IBM Cloud®. Un CRN viene utilizzato per specificare una risorsa in un modo non ambiguo che è garantito essere globalmente univoco.
Un CRN è formato da una concatenazione di "segmenti" che identificano gerarchicamente la risorsa, la sua posizione e il servizio a cui appartiene. Il delimitatore del segmento è impostato sui due punti (: ). Tutti i CRN
iniziano con l'identificatore del segmento crn.
Formato del CRN
Il formato tradizionale di base di un CRN è:
crn:version:cname:ctype:service-name:location:scope:service-instance:resource-type:resource
versione
Il segmento version identifica la versione del formato CRN. Attualmente, l'unico valore valido per il segmento della versione è v1.
cname
Il segmento cname identifica l'istanza cloud ed è un identificativo alfanumerico che identifica in modo univoco l'istanza cloud che contiene la risorsa. Un cname identifica efficacemente un piano di controllo indipendente
che possiede la risorsa identificata. Il valore per il segmento cname deve essere bluemix per gli utenti IBM Cloud.
ctype
Il segmento ctype identifica il tipo di istanza cloud rappresentato dal segmento cname specificato.
Valori validi:
public: tutti i servizi disponibili dal catalogo pubblicodedicated: solo per gli ambienti dedicati IBM Cloud correntilocal: tutti i servizi distribuiti localmente nel tuo ambiente
Nome di Servizio
IBM Cloud impone l'unicità globale dei nomi dei servizi. Il segmento “ service-name ” identifica una funzionalità (servizio, componente o prodotto) offerta dal cloud. La capacità può essere un servizio fornito dall'utente, come
i servizi elencati nel catalogo IBM Cloud, o un componente dell'architettura interna fondamentale per la funzionalità di IBM Cloud.
IL service-name il segmento indica il servizio a cui appartiene la risorsa. La parte “ service-name ” deve essere alfanumerica, in minuscolo e non deve contenere spazi né caratteri speciali, ad eccezione di -.
Se stai identificando un nome di servizio per un servizio per bambini, devi avere un punto . che separa il nome del servizio padre da quello figlio. Ad esempio, se hai un servizio chiamato iam-service e ne nascerà
un figlio micro,iam-service è il servizio genitore e iam-service.micro è considerato il servizio all'infanzia.
Per i servizi registrati nel catalogo IBM Cloud, il segmento service-name deve corrispondere a uno dei servizi registrati nel servizio del catalogo globale IBM Cloud. Si tratta della proprietà " name " restituita
dall'API del servizio Catalogo globale di IBM Cloud GET https://globalcatalog.cloud.ibm.com/api/v1/{id} per l'istanza della risorsa corrispondente, oppure del valore " service-name " visualizzato dall'interfaccia
della riga di comando (CLI): ibmcloud service offerings nella colonna " service ".
ubicazione
La geografia/regione/zona/data center nel cloud in cui risiede la risorsa.
IL location il segmento deve essere uno dei nomi di località elencati da ibmcloud catalog locations comando CLI.
Alcune risorse non richiedono una regione poiché possono essere considerate globali. In questo caso, il segmento region è impostato su global.
ambito
Il segmento scope identifica il contenimento o il proprietario della risorsa. Alcune risorse non richiedono un proprietario (possono essere considerate global). In questo caso, il segmento scope è vuoto
(una stringa vuota).
Il valore del segmento scope deve essere formattato come {scopePrefix}/{id}. scopePrefix rappresenta il formato utilizzato per identificare il proprietario o il contenimento. id rappresenta l'identità del proprietario o del contenimento in un formato specifico per scopePrefix.
| Tipo di ambito | Prefisso ambito | Utilizzo | Esempio |
|---|---|---|---|
| Account | a/{account id} |
L'account in cui è stata creata la risorsa. | a/292558 |
| Organizzazione | o/{org guid} |
L'organizzazione IBM Cloud a cui è stata assegnata la risorsa. | o/4716e2d1-35b7-431f-891a-b552bf0b3c66 |
| Spazio | s/{space guid} |
Lo spazio IBM Cloud a cui è stata assegnata la risorsa. | s/48b3cdcd-e804-4398-9032-73065863ad7c |
istanza di servizio
Il segmento service-instance identifica l'istanza del servizio in modo univoco. Il formato del segmento service-instance varia in base al servizio. Ogni servizio deve documentare il formato del proprio segmento service_instance come parte dei relativi metadati di servizio. Alcuni servizi non hanno istanze perché l'istanza è globale e, in questo caso, il campo service-instance è vuoto.
Il valore service-instance deve essere alfanumerico, in minuscolo, senza spazi o caratteri speciali diversi da '-' e '/'.
Ad esempio, aDevOps lo strumento utilizzato per tenere traccia e pianificare gli elementi di lavoro può avere un semplice GUID ID istanza ("1234-5678-9012-3456"). Tuttavia, il componente criteri di un servizio di gruppo
con scalabilità automatica può utilizzare una convenzione di denominazione gerarchica e avere un file service-id segmento di:
c7a27f55-d35e-4153-b044-8ca9155fc467/my-test-asg1/my-scaleout-policy
Puoi anche ottenere un CRN da una risorsa IBM Cloud utilizzando il seguente comando CLI:
ibmcloud resource service-instance
resource-type, resource
I valori dei segmenti resource-type e resource variano in base al servizio. Ogni servizio DEVE documentare i tipi di risorse supportati e il formato delle risorse stesse nell'ambito dei propri metadati di servizio.
Si noti che, se il CRN fa riferimento all'istanza del servizio, i segmenti “ resource-type ” e “ resource ” devono essere vuoti. Se si fa riferimento in modo globale al tipo di risorsa, i segmenti “ resource ” devono essere vuoti.
Ad esempio, un'immagine contenuta nel contenitore delle ricevute dei clienti in un servizio Object Storage potrebbe avere un resource-type e "object" e un resource e ''CustomerReceipts/clientdinner.png'. resource-type DEVE essere alfanumerico, in minuscolo, senza spazi né caratteri speciali diversi da '-'
Un servizio può stabilire che l' resource-type sia facoltativo; in tal caso, può essere omesso.
resource Deve essere un GUID o una stringa codificata secondo la sintassi URI descritta nella RFC 3986 "Uniform Resource Identifier(URI): Generic Syntax", Sezione 2.
In particolare, il carattere "/" può essere utilizzato per rappresentare un percorso gerarchico.
Esempi di CRN
La seguente tabella fornisce un elenco di esempi di CRN.
| Esempio | Valore |
|---|---|
| Worker Kubernetes | crn:v1:bluemix:public:containers-kubernetes:us-south:a/59bcbfa6ea2f006b4ed7094c1a08dcdd:8042b2a8af6a4a5cbf6dbe09e07311d2:worker:kube-hou02-pa8042b2a8af6a4a5cbf6dbe09e07311d2-w1 |
| Gruppo di risorse | crn:v1:bluemix:public:resource-controller:global:a/59bcbfa6ea2f006b4ed7094c1a08dcdd::resource-group:59bcbfa6ea2f006b4ed7094c1a08dcdd |
| Istanza del servizio | crn:v1:bluemix:public:cloud-object-storage:global:a/59bcbfa6ea2f006b4ed7094c1a08dcdd:1a0ec336-f391-4091-a6fb-5e084a4c56f4:: |
| Bucket | crn:v1:bluemix:public:cloud-object-storage:global:a/59bcbfa6ea2f006b4ed7094c1a08dcdd:1a0ec336-f391-4091-a6fb-5e084a4c56f4:bucket:mybucket |
| Servizio bambini | crn:v1:bluemix:public:resource-catalog:global:a/9d67f37fdf745e1b3cbef0ee4e6f2eda::composite:is-vpn |
Per visualizzare i passaggi di esempio per il recupero del valore CRN, vedere Recupero dell'ID istanza e del nome della risorsa cloud(CRN).