擷取實例 ID

您可以將個別 IBM Cloud® Hyper Protect Crypto Services 實例作為作業的目標，方法是在對服務的 API 要求中包括唯一 ID 或實例 ID。

使用使用者介面檢視實例 ID

您可以透過導覽到 Hyper Protect Crypto Services 資源清單來檢視與 IBM Cloud 服務實例相關聯的實例 ID。

登入使用者介面。
移至 功能表 > 資源清單，然後按一下服務以瀏覽雲端服務清單。
按一下說明您 Hyper Protect Crypto Services 服務實例的表格列。
移至概觀 > 實例，並複製 實例 ID 值。

此實例 ID 能唯一地識別您的 Hyper Protect Crypto Services 服務實例。

使用 CLI 擷取實例 ID

您也可以使用 IBM Cloud CLI 來擷取服務實例的實例 ID。

使用 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