インスタンス ID の取得

固有 ID (つまりインスタンス ID) をサービスへの API 要求に組み込むことによって、個別の IBM Cloud® Hyper Protect Crypto Services インスタンスを操作のターゲットにすることができます。

UI を使用したインスタンス ID の表示

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

UI にログインします。
「メニュー」>**「リソース・リスト」に移動し、「サービス」**をクリックしてクラウド・サービスのリストを参照します。
Hyper Protect Crypto Services サービス・インスタンスを記述している表の行をクリックします。
「概要」>**「インスタンス」に移動し、「インスタンス ID」**の値をコピーします。

この**「インスタンス ID」**は、Hyper Protect Crypto Services サービス・インスタンスを一意的に識別します。

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

サービス・インスタンスのインスタンス ID を、IBM Cloud CLI を使用して取得することもできます。

IBM Cloud CLI を使用して IBM Cloud にログインします。
```
ibmcloud login
```
ログインに失敗した場合は、ibmcloud login --ssoコマンドを実行して再試行してください。フェデレーテッドIDを使用してログインする場合は、--ssoパラメーターが必要です。このオプションを使用する場合、CLI 出力にリストされているリンクに移動して、ワンタイム・パスコードを生成します。
プロビジョン済みの Hyper Protect Crypto Services インスタンスを含んでいる、地域およびリソース・グループを選択します。次のコマンドを使用して、ターゲットのリージョンおよびリソース・グループを設定できます。
```
ibmcloud target -r <region_name> -g <resource_group_name>
```
Hyper Protect Crypto Services サービス・インスタンスを一意的に識別するクラウド・リソース名 (CRN) を取得します。
```
ibmcloud resource service-instance <instance_name> --id
```
<instance_name> を、Hyper Protect Crypto Services サービス・インスタンスに割り当てた固有のエイリアスに置き換えます。以下の切り取った例に、CLI 出力を示します。
```
crn:v1:public:hs-crypto: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 アクセス・トークンを生成します。
リソース・コントローラー API を呼び出して、インスタンス ID を取得します。
```
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'
```
<instance_name> を、Hyper Protect Crypto Services サービス・インスタンスに割り当てた固有のエイリアスに置き換えます。以下の出力は、インスタンス ID を示しています。
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```