Richiamo del tuo ID dell'istanza

Puoi indicare come destinazione una singola istanza IBM Cloud® Hyper Protect Crypto Services per le operazioni includendo l'identificativo univoco, o l'ID istanza, nelle richieste API al servizio.

Visualizzazione del tuo ID istanza con l'IU

Puoi visualizzare l'ID istanza associato alla tua istanza del servizio Hyper Protect Crypto Services passando al tuo elenco di risorse IBM Cloud.

Accedi all'IU.
Vai a Menu > Resource list e fai quindi clic su Services per sfogliare un elenco dei tuoi servizi cloud.
Fai clic sulla tabella che descrive la tua istanza del servizio Hyper Protect Crypto Services.
Vai a Overview > Instance e copia il valore Instance ID.

Questo Instance ID identifica in modo univoco la tua istanza del servizio Hyper Protect Crypto Services.

Richiamo di un ID istanza con la CLI

Puoi anche recuperare l'ID istanza per la tua istanza del servizio utilizzando la CLI IBM Cloud.

Accedi a IBM Cloud con la CLI IBM Cloud.
```
ibmcloud login
```
Se l'accesso non riesce, esegui il comando ibmcloud login --sso e prova di nuovo. Il parametro --sso è obbligatorio quando accedi con un ID federato. Se viene utilizzata questa opzione, vai al link elencato nell'output della CLI per generare una passcode monouso.
Seleziona la regione e il gruppo di risorse che contengono la tua istanza di Hyper Protect Crypto Services di cui è stato eseguito il provisioning. Puoi utilizzare il seguente comando per impostare la regione e il gruppo di risorse.
```
ibmcloud target -r <region_name> -g <resource_group_name>
```
Richiama il CRN (Cloud Resource Name) che identifica in modo univoco la tua istanza del servizio Hyper Protect Crypto Services.
```
ibmcloud resource service-instance <instance_name> --id
```
Sostituisci <instance_name> con l'alias univoco che hai assegnato alla tua istanza del servizio Hyper Protect Crypto Services. Il seguente esempio troncato mostra l'output della CLI.
```
crn:v1:public:hs-crypto:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
Il valore 42454b3b-5b06-407b-a4b3-34d9ef323901 è un ID dell'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 richiamare IBM Cloud Resource Controller APIe quindi inviare l'output JSON a jq per estrarre questo valore.

Richiama un token di accesso IBM Cloud IAM.
Richiama l'API Resource Controller per richiamare il tuo ID istanza.
```
curl -X GET \
https://resource-controller.cloud.ibm.com/v2/resource_instances \
-H 'Authorization: Bearer <access_token>' | jq -r '.resources[] | select(.name | contains("<instance_name>")) | .guid'
```
Sostituisci <instance_name> con l'alias univoco che hai assegnato alla tua istanza del servizio Hyper Protect Crypto Services. Il seguente output mostra un ID istanza di esempio:
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```