Come recuperare l'ID dell'istanza e il nome della risorsa cloud (CRN)

È possibile specificare un’istanza IBM® Key Protect specifica per le operazioni includendo il suo identificatore univoco, ovvero l’ID dell’istanza, nelle richieste API inviate al servizio. Allo stesso modo, può essere utile conoscere il nome della risorsa cloud(CRN) di riferimento.

Visualizzazione dell'ID dell'istanza e del CRN nella console IBM Cloud

È possibile visualizzare l'ID dell'istanza associata alla propria istanza di Key Protect accedendo all'elenco delle risorse su IBM Cloud.

Accedi alla console di IBM Cloud.
Vai su Menu > Elenco risorse, quindi fai clic su Servizi per visualizzare l'elenco dei tuoi servizi cloud.
Fai clic sulla riga della tabella. In questo modo si apre il pannello laterale della tabella delle risorse, dove è possibile visualizzare il CRN e il GUID dell'istanza.
Clicca sul link con il nome dell'istanza. In questo modo si aprirà la tua istanza di Key Protect.
Nella pagina Panoramica, individua la sezione Istanza. L'ID dell'istanza e il CRN sono riportati qui sotto sotto forma di frammenti di codice.

Come recuperare un ID istanza e un CRN tramite la CLI

È inoltre possibile recuperare l'ID dell'istanza relativa al proprio Key Protect ad esempio utilizzando il IBM Cloud CLI.

Accedi a IBM Cloud con le IBM Cloud CLI.
```
ibmcloud login
```
Se l'accesso non riesce, esegui il comando ibmcloud login --sso e prova di nuovo. L'intestazione --sso Questo parametro è obbligatorio quando si effettua l'accesso con un ID federato. Se viene utilizzata questa opzione, vai al link elencato nell'output della CLI per generare una passcode monouso.
Seleziona l'account, la regione e il gruppo di risorse che contengono la tua istanza di cui è stato eseguito il provisioning di Key Protect.
Recupera il nome della risorsa cloud (CRN) che identifica in modo univoco il tuo Key Protect ad esempio.
```
ibmcloud resource service-instance <instance_name> --id
```
Sostituisci <instance_name> con l'alias univoco che hai assegnato al tuo Key Protect ad esempio. Se non conosci il nome della tua istanza, esegui il comando [ibmcloud resource service-instancescomando](/docs/cli?topic=cli-ibmcloud_commands_resource#ibmcloud_resource_service_instances) per ottenere un elenco dei nomi delle istanze che hai creato nella regione selezionata.

Il seguente esempio troncato mostra l'output della CLI.
```
crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
Il 42454b3b-5b06-407b-a4b3-34d9ef323901 valore è un ID di istanza di esempio.

Richiamo di un ID istanza con l'API

Potresti voler richiamare l'ID istanza in modo programmatico per aiutarti a creare e connettere la tua applicazione. Puoi chiamare il IBM Cloud API del Resource Controller, quindi reindirizzare l'output JSON a jq per estrarre questo valore.

Richiama un token di accesso IBM Cloud IAM.
Chiama l' API del Resource Controller per recuperare l'ID della tua istanza.
```
$ curl -X GET \
    "https://resource-controller.cloud.ibm.com/v2/resource_instances" \
    -H "authorization: Bearer <IAM_token>" | jq -r '.resources[] | select(.name | contains("<instance_name>")) | .guid'
```
Sostituisci <instance_name> con l'alias univoco che hai assegnato al tuo Key Protect ad esempio. Se non conosci il nome della tua istanza, effettua una richiesta GET /v2/resource_instancesper recuperare l'elenco dei nomi delle istanze che hai creato nella regione selezionata.

Il seguente output mostra un ID istanza di esempio:
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```