Extraction de l'ID d'instance

Vous pouvez cibler une instance IBM Cloud® Hyper Protect Crypto Services spécifique pour les opérations en incluant l'identificateur unique, ou l'ID instance, dans les demandes d'API au service.

Affichage de votre ID instance avec l'interface utilisateur

Vous pouvez afficher l'ID d'instance associé à votre instance de service Hyper Protect Crypto Services en accédant à votre liste de ressources IBM Cloud.

Connectez-vous à l'interface utilisateur.
Accédez à Menu > Liste de ressources, puis cliquez sur Services pour parcourir la liste de vos services de cloud.
Cliquez sur la ligne qui décrit votre instance de service Hyper Protect Crypto Services.
Accédez à Aperçu > Instance et copiez la valeur ID d'instance.

Cette valeur ID d'instance identifie de façon unique votre instance de service Hyper Protect Crypto Services.

Extraction d'un ID d'instance à l'aide de l'interface de ligne de commande

Vous pouvez aussi extraire l'ID instance de votre instance de service en utilisant l'interface de ligne de commande d'IBM Cloud.

Connectez-vous à IBM Cloud à l'aide de l'interface de ligne de commande d'IBM Cloud.
```
ibmcloud login
```
Si la connexion échoue, exécutez la commande ibmcloud login --sso pour réessayer. Le paramètre --sso est requis lorsque vous vous connectez avec un ID fédéré. Si cette option est utilisée, allez sur le lien répertorié dans la sortie d'interface de ligne de commande pour générer un code d'accès unique.
Sélectionnez la région et le groupe de ressources qui contiennent votre instance Hyper Protect Crypto Services mise à disposition. Vous pouvez également utiliser la commande ci-dessous pour définir votre région et votre groupe de ressources cible.
```
ibmcloud target -r <region_name> -g <resource_group_name>
```
Extrayez le nom CRN (Cloud Resource Name) qui identifie de manière unique l'instance de service Hyper Protect Crypto Services.
```
ibmcloud resource service-instance <instance_name> --id
```
Remplacez <instance_name> par l'alias unique que vous avez affecté à votre instance de service Hyper Protect Crypto Services. L'exemple partiel suivant présente la sortie de l'interface de ligne de commande.
```
crn:v1:public:hs-crypto:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
La valeur 42454b3b-5b06-407b-a4b3-34d9ef323901 est un exemple d'ID d'instance.

Extraction d'un ID d'instance à l'aide de l'API

Si vous le souhaitez, vous pouvez extraire l'ID d'instance à l'aide d'un programme pour générer et connecter votre application. Vous pouvez appeler l'API de contrôleur de ressourcesIBM Cloud, puis acheminer la sortie JSON vers jq pour extraire cette valeur.

Extrayez un jeton d'accès IBM Cloud IAM.
Appelez l'API du contrôleur de ressources pour extraire votre ID d'instance.
```
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'
```
Remplacez <instance_name> par l'alias unique que vous avez affecté à votre instance de service Hyper Protect Crypto Services. La sortie suivante montre un exemple d'ID d'instance :
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```