Recuperando o ID de sua instância

É possível destinar uma instância IBM Cloud® Hyper Protect Crypto Services individual para operações incluindo o identificador exclusivo ou o ID da instância, em solicitações de API para o serviço.

Visualizando seu ID da instância com a IU

É possível visualizar o ID da instância que está associado à sua instância de serviço do Hyper Protect Crypto Services navegando para a sua lista de recursos do IBM Cloud.

Efetue login na IU.
Acesse Menu > Lista de recursos e, em seguida, clique em Serviços para navegar em uma lista de seus serviços em nuvem.
Clique na linha da tabela que descreve sua instância de serviço do Hyper Protect Crypto Services.
Acesse Visão geral > Instância, e copie o valor de ID da instância.

Esse ID da instância identifica exclusivamente sua instância de serviço do Hyper Protect Crypto Services.

Recuperando um ID da instância com a CLI

Você também pode recuperar o ID da instância para sua instância de serviço usando o IBM Cloud CLI.

Faça login no IBM Cloud com a CLI do IBM Cloud.
```
ibmcloud login
```
Se o login falhar, execute o comando ibmcloud login --sso para tentar novamente. O parâmetro --sso é necessário quando você efetua login com um ID federado. Se essa opção for usada, acesse o link listado na saída da CLI para gerar uma senha descartável.
Selecione a região e o grupo de recursos que contêm sua instância provisionada do Hyper Protect Crypto Services. É possível usar o comando a seguir para configurar sua região de destino e grupo de recursos.
```
ibmcloud target -r <region_name> -g <resource_group_name>
```
Recupere o Cloud Resource Name (CRN) que identifica exclusivamente sua instância de serviço do Hyper Protect Crypto Services.
```
ibmcloud resource service-instance <instance_name> --id
```
Substitua <instance_name> pelo alias exclusivo que você designou para a sua instância de serviço do Hyper Protect Crypto Services. O exemplo truncado a seguir mostra a saída da CLI.
```
crn:v1:public:hs-crypto:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
O valor 42454b3b-5b06-407b-a4b3-34d9ef323901 é um ID da instância de exemplo.

Recuperando um ID da instância com a API

Talvez você queira recuperar o ID da instância programaticamente para ajudar a construir e conectar seu aplicativo. É possível chamar o IBM Cloud Resource Controller APIe, em seguida, canalizar a saída JSON para jq para extrair esse valor.

Recupere um token de acesso do IBM Cloud IAM.
Chame a API do Resource Controller para recuperar seu ID da instância.
```
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'
```
Substitua <instance_name> pelo alias exclusivo que você designou para a sua instância de serviço do Hyper Protect Crypto Services. A saída a seguir mostra um ID de instância de exemplo:
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```