Recuperación del ID de instancia

Puede apuntar a una instancia de IBM Cloud® Hyper Protect Crypto Services individual para operaciones incluyendo el identificador exclusivo, o el ID de instancia, en las solicitudes de API para el servicio.

Visualización del ID de instancia con la interfaz de usuario

Puede ver el ID de instancia asociado a su instancia de servicio de Hyper Protect Crypto Services navegando a la lista de recursos de IBM Cloud.

Inicie sesión en la interfaz de usuario.
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 tabla que describe su instancia de servicio de Hyper Protect Crypto Services.
Vaya a Visión general > Instancia y copie el valor ID de instancia.

Este ID De instancia solamente identifica su instancia de servicio de Hyper Protect Crypto Services.

Recuperación de un ID de instancia con la CLI

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

Inicie una sesión en IBM Cloud con la CLI de IBM Cloud.
```
ibmcloud login
```
Si el inicio de sesión falla, ejecute el mandato ibmcloud login --sso para volver a intentarlo. Se requiere el parámetro --sso para iniciar sesión con un ID federado. 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 región y el grupo de recursos que contiene la instancia suministrada de Hyper Protect Crypto Services. Utilice el siguiente mandato para establecer la región de destino y el grupo de recursos.
```
ibmcloud target -r <region_name> -g <resource_group_name>
```
Recupere el nombre de recurso de nube (CRN) que identifica de forma exclusiva su instancia de servicio de Hyper Protect Crypto Services.
```
ibmcloud resource service-instance <instance_name> --id
```
Sustituya <instance_name> por el alias exclusivo que ha asignado a la instancia de servicio de Hyper Protect Crypto Services. En el siguiente ejemplo truncado se muestra la salida de la CLI.
```
crn:v1:public:hs-crypto:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
El valor 42454b3b-5b06-407b-a4b3-34d9ef323901 es un ID de instancia de ejemplo.

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 API de controlador de recursos deIBM Cloudy, a continuación, dirigir la salida JSON a jq para extraer este valor.

Recupere una señal de acceso de IBM Cloud IAM.
Llame a la API del controlador de recursos para recuperar el ID de instancia.
```
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'
```
Sustituya <instance_name> por el alias exclusivo que ha asignado a la instancia de servicio de Hyper Protect Crypto Services. En la siguiente salida se muestra un ejemplo de ID de instancia:
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```