檢視與根金鑰相關聯的受保護資源

1. 登入使用者介面。

2. 去選單>資源列表查看您的資源清單。

3. 從 IBM Cloud 資源清單，選取已佈建的 Hyper Protect Crypto Services 實例。

4. 上 KMS 金鑰頁面，使用按鍵表來瀏覽您服務中的金鑰。

5. 若要檢視特定根金鑰的受保護資源，請按一下 動作 圖示 以開啟金鑰的選項清單，然後選取 檢視關聯資源 以瀏覽金鑰所保護的所有資源。

   表 2. 說明檢視相關聯資源的表格

   直欄	說明
   Resource name	與金鑰相關聯的雲端資源 (例如 Cloud Object Storage 儲存區) 名稱。
   Service name	資源所在 IBM Cloud 服務實例的名稱。
   Retention policy	雲端資源是否具有保留原則。 如果值為 True，則針對雲端資源啟用保留原則，並且無法刪除與雲端資源相關聯的金鑰。 如果值為 False，則不會啟用保留原則。

6. 若要檢視每一個資源的詳細資料，請按一下 Resource name 直欄下的脫字符號 (^) 圖示，以展開資源詳細資料。

   下表描述了註冊詳細資訊。

   表 3. 說明與資源相關聯的內容

   欄位	說明
   Created	資源第一次與金鑰相關聯的日期和時間。
   Last updated	更新註冊的日期和時間。
   Description	登錄的說明。
   Key version ID	保護雲端資源的根金鑰版本。
   Key version date	更新主要金鑰版本的日期和時間。
   Cloud resource name	代表與金鑰相關聯的雲端資源，包括「雲端資源名稱 (CRN)」、version、cname、ctype 等。

您可以使用搜尋欄位，以資源名稱或金鑰版本 ID 來搜尋與根金鑰相關聯的任何資源。

檢視實例中的資源

1. 登入使用者介面。

2. 去選單>資源列表查看您的資源清單。

3. 從 IBM Cloud 資源清單，選取已佈建的 Hyper Protect Crypto Services 實例。

4. 在 KMS 關聯資源 頁面上，使用 金鑰管理服務關聯資源 表格來瀏覽服務中的登錄。

   表 4. 說明相關聯資源的表格

   直欄	說明
   Resource name	與金鑰相關聯的雲端資源 (例如 Cloud Object Storage 儲存區) 名稱。
   Key name	人類可讀的名稱，用於識別與所指定雲端資源相關聯的根金鑰。
   Key ID	識別與指定雲端資源相關聯的根金鑰的 ID。
   Service name	資源所在 IBM Cloud 服務實例的名稱。
   Retention policy	指出是否可以消除雲端資源。 如果值為 Enabled，則無法消除雲端資源，且無法刪除與雲端資源相關聯的索引鍵。 如果值為 Disabled，則可以消除雲端資源。 必要的話，您可以刪除與雲端資源相關聯的金鑰。

5. 按一下 Resource name 直欄下的脫字符號 (^) 圖示，以檢視特定登錄的詳細資料清單。

   下表描述了註冊詳細資訊。

   表 5. 說明與資源相關聯的內容

   欄位	說明
   Created	資源第一次與金鑰相關聯的日期和時間。
   Last updated	更新註冊的日期和時間。
   Description	登錄的說明。
   Key version ID	保護雲端資源的根金鑰版本。
   Key version date	更新主要金鑰版本的日期和時間。
   Cloud resource name	代表與金鑰相關聯的雲端資源，包括「雲端資源名稱 (CRN)」、version、cname、ctype 等。

除了搜尋資源之外，您也可以依「資源名稱」、金鑰 ID 及保留原則來尋找資源。 若要這樣做，請按一下 Filter 按鈕，從清單中選取過濾選項，然後按一下 套用。

使用 API 列出特定根金鑰的登錄

您可以對下列端點發出 GET 呼叫，以擷取與特定根金鑰相關聯的登錄詳細資料。

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/registrations

1. 擷取鑑別認證以使用 API。

2. 執行下列 cURL 指令，以檢視與根金鑰相關聯的登錄。

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/registrations \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

   根據下表取代範例要求中的變數。

   表 7. 說明列出與根金鑰相關聯的所有登錄所需的變數

   變數	說明
   region	必要。 地區縮寫，例如 us-south 或者 eu-de，代表您所在的地理區域Hyper Protect Crypto Services實例駐留。 如需相關資訊，請參閱地區服務端點。
   port	必要。 API 端點的埠號。
   IAM_token	必要。 您的 IBM Cloud 存取記號。 請在 cURL 要求中包含 IAM 記號的完整內容，包括 Bearer 值。 有關更多信息，請參閱 檢索訪問令牌。
   instance_ID	必要。 指派給您 Hyper Protect Crypto Services 服務實例的唯一 ID。 有關更多信息，請參閱 檢索實例 ID。

   成功的 GET api/v2/keys/<key_ID>/registrations 要求會傳回對映至指定索引鍵 ID 的登錄集合。

   {
     "metadata": {
         "collectionType": "application/vnd.ibm.kms.registration+json",
         "collectionTotal": 2
     },
     "resources": [
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       },
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       }
     ]
   }
   

   resourceCrn 值代表 keyId 所加密雲端資源的唯一 ID。 與登錄相關聯的 meta 資料 (例如建立日期) 也會在回應內文中傳回。

   預設情況下，GET api/v2/keys/registrations 返回前 200 個註冊，但您可以使用以下命令調整此限制 limit 查詢時的參數。

使用 API 列出任何根金鑰的登錄

您也可以對下列端點發出 GET 呼叫，以擷取與任何雲端資源相關聯的登錄清單。

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query>

1. 擷取鑑別認證以使用 API。

2. 執行下列 cURL 指令，以檢視符合您所指定 CRN 查詢的登錄。

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query> \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

   根據下表取代範例要求中的變數。

   表 8. 說明依 CRN 查詢列出登錄所需的變數。

   變數	說明
   region	必要。 地區縮寫，例如 us-south 或者 eu-de，代表您所在的地理區域Hyper Protect Crypto Services實例駐留。 如需相關資訊，請參閱地區服務端點。
   port	必要。 API 端點的埠號。
   url_encoded_CRN_query	使用 URL 編碼萬用字元 (*) 來過濾與指定 雲端資源名稱(CRN) 相關聯的資源。參數需要包含所有 CRN 區段，且必須以 URL 編碼。 若要檢視範例，請參閱 CRN 查詢範例。
   IAM_token	必要。 您的 IBM Cloud 存取記號。 請在 cURL 要求中包含 IAM 記號的完整內容，包括 Bearer 值。 有關更多信息，請參閱 檢索訪問令牌。
   instance_ID	必要。 指派給您 Hyper Protect Crypto Services 服務實例的唯一 ID。 有關更多信息，請參閱 檢索實例 ID。