インスタンス ID とクラウド・リソース名 (CRN) の取得

IBM® Key Protect インスタンスの固有 ID (つまりインスタンス ID) をサービスへの API 要求に組み込むことによって、個別のサービス・インスタンスを操作のターゲットにすることができます。同様に、該当するクラウド・リソース名 (CRN) もわかっていると役に立ちます。

IBM Cloud コンソールでのインスタンス ID および CRN の表示

Key Protect リソース・リストにナビゲートすることによって、 IBM Cloud インスタンスと関連付けられたインスタンス ID を表示できます。

IBM Cloud コンソールにログインしてください。
「メニュー」>**「リソース・リスト」に移動し、「サービス」**をクリックしてクラウド・サービスのリストを参照します。
テーブルの行をクリックします。リソース・テーブルのサイド・パネルが開き、CRN とインスタンス GUID が表示されます。
インスタンス名のリンクをクリックします。 Key Protect インスタンスが開きます。
「概要」ページで、「 インスタンス 」セクションを探してください。ここには、コード・スニペットとしてインスタンス ID と CRN が表示されます。

CLI を使用したインスタンス ID と CRN の取得

また、以下のインスタンス ID を取得することもできます。 Key Protect インスタンス (以下を使用) IBM Cloud CLI。

以下を使用して IBM Cloud にログインします。 IBM Cloud CLI。
```
ibmcloud login
```
ログインに失敗した場合は、ibmcloud login --ssoコマンドを実行して再試行してください。この --sso フェデレーテッドIDでログインする際は、このパラメータの指定が必要です。このオプションを使用する場合、CLI 出力にリストされているリンクに移動して、ワンタイム・パスコードを生成します。
プロビジョン済みの Key Protect インスタンスを含んでいる、アカウント、地域、およびリソース・グループを選択します。
以下のインスタンスを固有に識別するクラウド・リソース名 (CRN) を取得します。 Key Protect インスタンス。
```
ibmcloud resource service-instance <instance_name> --id
```
<instance_name>を、以下のインスタンスに割り当てた固有の別名に置き換えます。 Key Protect インスタンス。インスタンス名がわからない場合は、ibmcloud resource service-instances コマンドを実行して、選択したリージョンでプロビジョンしたインスタンス名のリストを取得します。

以下の切り取った例に、CLI 出力を示します。
```
crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
42454b3b-5b06-407b-a4b3-34d9ef323901 の値は、インスタンス ID の例です。

API を使用したインスタンス ID の取得

アプリケーションの構築と接続をサポートするために、インスタンス ID をプログラマチックに取得する方法がよい場合があります。以下を呼び出してから IBM Cloud リソースコントローラー API、そして、JSON 出力を jq にパイプして、この値を抽出します。

IBM Cloud IAM アクセス・トークンを取得します。
インスタンス ID を取得するには、リソースコントローラー API を呼び出してください。
```
$ 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'
```
<instance_name>を、以下のインスタンスに割り当てた固有の別名に置き換えます。 Key Protect インスタンス。インスタンスの名前がわからない場合は、GET /v2/resource_instances リクエストを実行して、選択したリージョンでプロビジョニングしたインスタンス名のリストを取得してください。

以下の出力は、インスタンス ID を示しています。
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```