Recuperando seu ID de instância e o nome do recurso em nuvem (CRN)

É possível apontar uma instância individual do IBM® Key Protect como destino para operações incluindo seu identificador exclusivo ou ID da instância em solicitações de API para o serviço. Da mesma forma, também pode ser útil saber seu nome do recurso em nuvem (CRN) relevante.

Visualizando seu ID de instância e o CRN no console do IBM Cloud

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

Faça login no console do IBM Cloud.
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. Isso abre o painel lateral da tabela de recursos, onde é possível ver o CRN e o GUID da instância.
Clique no link do nome da instância. Isso abrirá sua instância do Key Protect.
Na página “Visão geral ”, localize a seção “Instância ”. Seu ID de instância e o CRN estão listados aqui como fragmentos de código.

Recuperando um ID de instância e um CRN com a CLI

Também é possível recuperar o ID da instância do instância do Key Protect, é possível utilizar IBM Cloud CLI.

Efetue login no IBM Cloud usando IBM Cloud CLI.
```
ibmcloud login
```
Se o login falhar, execute o comando ibmcloud login --sso para tentar novamente. Os comandos --sso Esse parâmetro é obrigatório quando você faz login com uma identificação federada. Se essa opção for usada, acesse o link listado na saída da CLI para gerar uma senha descartável.
Selecione a conta, a região e o grupo de recursos que contêm sua instância provisionada do Key Protect.
Recupere o Nome do recurso de nuvem (CRN) que identifica com exclusividade sua instância do Key Protect.
```
ibmcloud resource service-instance <instance_name> --id
```
Substitua <instance_name> pelo alias exclusivo designado para a instância do Key Protect. Se não souber o nome de sua instância, execute o comando ibmcloud resource service-instances para recuperar uma lista de nomes de instâncias provisionados na região selecionada.

O exemplo truncado a seguir mostra a saída da CLI.
```
crn:v1:bluemix:public:kms: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 a IBM Cloud API do Controlador de Recursos, e, em seguida, encaminhe a saída JSON para jq para extrair esse valor.

Recupere um token de acesso do IBM Cloud IAM.
Chame a API do Controlador de Recursos para recuperar o ID da sua instância.
```
$ 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'
```
Substitua <instance_name> pelo alias exclusivo designado para a instância do Key Protect. Se você não souber o nome da sua instância, faça uma solicitação GET /v2/resource_instancespara obter uma lista dos nomes das instâncias que você provisionou na região selecionada.

A saída a seguir mostra um ID de instância de exemplo:
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```