インスタンス内の保護リソースの表示

1. IBM Cloud コンソールにログインしてください。

2. 「メニュー」>**「リソース・リスト」**に移動し、リソースのリストを表示します。

3. IBM Cloud リソース・リストで、Key Protect のプロビジョン済みインスタンスを選択します。

4. 左側のメニューでAssociated resourcesリンクを選択します。

5. 「関連リソース (Associated resources)」ページの**「関連リソース (Associated Resources)」**テーブルを使用して、サービス内の登録を参照します。

6. 特定の登録の詳細のリストを表示するには、^列の下にあるDetailsアイコンをクリックします。

7. 鍵 ID、クラウド・リソース名 (CRN)、保存ポリシーでリソースをフィルタリングするには、Filterボタンをクリックします。

鍵に関連付けられた保護リソースの表示

1. IBM Cloud コンソールにログインしてください。

2. 「メニュー」>**「リソース・リスト」**に移動し、リソースのリストを表示します。

3. IBM Cloud リソース・リストで、Key Protect のプロビジョン済みインスタンスを選択します。

4. アプリケーションの詳細ページで、**「鍵 (Keys)」**テーブルを使用して、サービス内の鍵を参照します。

5. 「⋯」アイコンをクリックして、鍵のオプションのリストを開きます。

6. オプション・メニューから、**「鍵の関連リソース (Key associated resources)」**をクリックして、鍵の関連登録を表示します。

特定のルート鍵の登録のリスト

以下のエンドポイントへの GET 呼び出しを行うことによって、特定のルート鍵と関連付けられている登録の詳細を取得できます。

https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations

1. API の処理を行うために、認証資格情報を取得します。

2. 以下の curl コマンドを実行して、ルート鍵と関連付けられている登録を表示します。

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>"
   

   次の表に従って、例の要求内の変数を置き換えてください。

GET api/v2/keys/<keyID_or_alias>/registrations 要求が成功すると、指定されたキー ID にマップされた登録のコレクションが返されます。

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.registration+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "keyId": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
                "creationDate": "2010-01-12T05:23:19+0000"
            }
        },
        {
            "keyId": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
                "creationDate": "2010-01-12T05:23:19+0000"
            }
        }
    ]
}

resourceCrn 値は、keyId によって暗号化されたクラウド・リソースの固有 ID を表します。 登録に関連付けられているメタデータ (作成日など) も応答本体で返されます。

デフォルトでは、GET api/v2/keys/registrations は最初の 200 個の登録を返しますが、照会時に limit パラメーターを使用してこの制限を調整できます。

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations?offset=<offset>&limit=<limit>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

任意のルート鍵の登録のリスト

以下のエンドポイントへの GET 呼び出しを行うことによって、任意のクラウド・リソースと関連付けられた登録のリストを取得することもできます。

https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations

1. API の処理を行うために、認証資格情報を取得します。

2. 以下の curl コマンドを実行して、指定する CRN 照会に一致する登録を表示します。

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>"
   

   次の表に従って、例の要求内の変数を置き換えてください。

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations?offset=<offset>&limit=<limit>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

CRN 照会例

URL エンコードされた CRN 照会を使用して、以下によって登録をフィルタリングします。 Key Protect インスタンス、リソース・タイプ、またはリソース名。 CRNのセグメントおよび形式について詳しくは、 「 クラウドリソース名 」を参照してください。

Key Protect を使用して、 鍵をリソースに関連付けているクラウド・サービスは、サービス CRN の最初の 8 つセグメントに一致する CRN のみを表示または照会することができます。

• 登録の存在の検索を、特定の CRN セグメントまで行うには、コロンとそれに続くアスタリスク (*) を使用します。

  crn:v1:bluemix:public:databases-for-redis:us-south:a/
  274074dce64e9c423ffc238516c755e1:29caf0e7-120f-4da8-9551-3abf57ebcfc7:*:*
  

  このクエリーは、デプロイメント ID 29caf0e7-120f-4da8-9551-3abf57ebcfc7 のすべてのリソース・タイプおよび名前に関連付けられた Databases for Redis 登録を返します。

• <string> という接頭部が付いた特定の CRN セグメントまでの登録の存在を検索するには、CRN 照会の最後のセグメントでコロンの後に <string>* を使用します。

  crn:v1:bluemix:public:cloud-object-storage:global:a/e1bb63d6a20dc57c87501ac4c4c99dcb:*:bucket:prod*
  

  このクエリーは、接頭部 prod が付いたアカウント e1bb63d6a20dc57c87501ac4c4c99dcb のすべての Cloud Object Storage バケット登録を返します。

いずれかのルートキーに関連付けられている登録情報を 一覧表示する場合、CRNクエリの最初の8つのセグメントにはアスタリスク（*）を含めないでください。

以下の表に、URL エンコードを行う前と後の CRN 照会の例を示します。 URL エンコードされた値を表示するには、**「URL エンコード」**タブをクリックします。