Recuperación del ID de instancia y el nombre de recurso de nube (CRN)

Puede elegir como destino una instancia de IBM® Key Protect para operaciones incluyendo su identificador exclusivo o ID de instancia en las solicitudes de API al servicio. Del mismo modo, también puede ser útil conocer su nombre de recurso de nube (CRN) relevante.

Visualización del ID de instancia y CRN en la consola IBM Cloud

Puede ver el ID de instancia que está asociado a la instancia de Key Protect yendo a la lista de recursos de IBM Cloud.

Inicia sesión en la consola de IBM Cloud.
Vaya a Menú > Lista de recursos y, a continuación, pulse Servicios para examinar una lista de los servicios de nube.
Pulse la fila de la tabla. Esto abre el panel lateral de la tabla de recursos, donde puede ver el CRN y el GUID de la instancia.
Pulse el enlace del nombre de la instancia. Esto abrirá la instancia de Key Protect.
En la página «Resumen», busca la sección « Instancia ». El ID de instancia y CRN se enumeran aquí como fragmentos de código.

Recuperación de un ID de instancia y CRN mediante la CLI

También puede recuperar el ID de instancia de su instancia de Key Protect utilizando la IBM Cloud CLI.

Inicie sesión en IBM Cloud con la IBM Cloud CLI.
```
ibmcloud login
```
Si el inicio de sesión falla, ejecute el mandato ibmcloud login --sso para volver a intentarlo. La cabecera HTTP --sso Este parámetro es obligatorio cuando inicias sesión con una identificación federada. Si se utiliza esta opción, vaya al enlace que se muestra en la salida de la CLI para generar una contraseña de uso único.
Seleccione la cuenta, la región y el grupo de recursos que contienen la instancia suministrada de Key Protect.
Recupere el nombre de recurso de nube (CRN) que identifica de forma exclusiva a su instancia de Key Protect.
```
ibmcloud resource service-instance <instance_name> --id
```
Sustituya <instance_name> por el alias exclusivo que ha asignado a su instancia de Key Protect. Si no conoces el nombre de tu instancia, ejecuta la consulta « ibmcloud resource service-instances comando » para obtener una lista de los nombres de las instancias que has aprovisionado en la región seleccionada.

En el siguiente ejemplo truncado se muestra la salida de la CLI.
```
crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
El valor 42454b3b-5b06-407b-a4b3-34d9ef323901 es un ejemplo de un ID de instancia.

Recuperación de un ID de instancia con la API

Es posible que desee recuperar el ID de instancia mediante programación como ayuda para crear y conectar su aplicación. Puede llamar a la IBM Cloud API del controlador de recursos, y, a continuación, canalizar la salida JSON a jq para extraer este valor.

Recupere una señal de acceso de IBM Cloud IAM.
Llama a la API del controlador de recursos para obtener el ID de tu instancia.
```
$ 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'
```
Sustituya <instance_name> por el alias exclusivo que ha asignado a su instancia de Key Protect. Si no conoces el nombre de tu instancia, envía una solicitud GET /v2/resource_instancespara obtener una lista de los nombres de las instancias que has aprovisionado en la región seleccionada.

En la siguiente salida se muestra un ejemplo de ID de instancia:
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```