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

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

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

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

IBM Cloud コンソールにログインします。
「メニュー」 & gt; **「リソース・リスト」に移動し、「サービス」**をクリックしてクラウド・サービスのリストを参照します。
テーブルの行をクリックします。リソース・テーブルのサイド・パネルが開き、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コマンドを実行して再試行してください。フェデレーテッドIDを使用してログインする場合は、--ssoパラメーターが必要です。このオプションを使用する場合、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 Resource Controller API)、JSON 出力をjqにパイプして、この値を抽出します。

IBM Cloud IAM アクセス・トークンを取得します。
Resource Controller API を呼び出して、インスタンス ID を取得します。
```
$ 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
```