Extraction de votre ID d'instance et du nom de ressource de cloud (CRN)

Vous pouvez cibler une instance IBM® Key Protect individuelle pour les opérations en incluant son identificateur unique, ou ID d'instance, dans les demandes d'API au service. De même, il peut également être utile de connaître votre nom de ressource de cloud (CRN)approprié.

Affichage de votre ID d'instance et nom de ressource de cloud dans la console IBM Cloud

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

Connectez-vous à la console IBM Cloud.
Accédez à Menu > Liste de ressources, puis cliquez sur Services pour parcourir la liste de vos services de cloud.
Cliquez sur la ligne de la table. Le panneau latéral de la table des ressources s'ouvre, dans lequel vous pouvez voir le nom de ressource de cloud et l'identificateur global unique de l'instance.
Cliquez sur le lien du nom d'instance. Votre instance Key Protect s'ouvre.
Dans la page « Aperçu », repérez la section « Instance ». Vos ID d'instance et nom de ressource de cloud sont répertoriés ici en tant que fragments de code.

Extraction d'un ID d'instance et d'un nom de ressource de cloud à l'aide de l'interface de ligne de commande

Vous pouvez également extraire l'ID instance de votre instance Key Protect à l'aide de IBM Cloud CLI.

Connectez-vous à IBM Cloud avec IBM Cloud CLI.
```
ibmcloud login
```
Si la connexion échoue, exécutez la commande ibmcloud login --sso pour réessayer. :NONE. --sso Ce paramètre est obligatoire lorsque vous vous connectez avec un identifiant 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 le compte, la région et le groupe de ressources contenant votre instance Key Protect mise à disposition.
Extrayez le nom de ressource de cloud (CRN) qui identifie de manière unique votre instance Key Protect.
```
ibmcloud resource service-instance <instance_name> --id
```
Remplacez <instance_name> par l'alias unique que vous avez affecté à votre instance Key Protect. Si vous ne connaissez pas le nom de votre instance, exécutez la commande « ibmcloud resource service-instances » pour obtenir la liste des noms d'instances que vous avez provisionnées dans la région sélectionnée.

L'exemple partiel suivant présente la sortie de l'interface de ligne de commande.
```
crn:v1:bluemix:public:kms: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 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 IBM Cloud API du contrôleur de ressources, puis rediriger le flux 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 récupérer l'identifiant de votre instance.
```
$ 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'
```
Remplacez <instance_name> par l'alias unique que vous avez affecté à votre instance Key Protect. Si vous ne connaissez pas le nom de votre instance, effectuez une requête GET /v2/resource_instancespour obtenir la liste des noms d'instances que vous avez provisionnées dans la région sélectionnée.

La sortie suivante montre un exemple d'ID d'instance :
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```