檢索您的實例 ID 和雲端資源名稱 (CRN)

您可以透過在向該服務發送的 API 請求中包含其唯一識別碼（即實例 ID），來針對特定的 IBM® Key Protect 實例執行操作。 同樣地，了解相關的 雲端資源名稱（CRN） 也會有所幫助。

在 IBM Cloud 控制台中查看您的實例 ID 和 CRN

您可以透過瀏覽 IBM Cloud 資源清單，查看與您的 Key Protect 實例相關聯的實例 ID。

  1. 登入 IBM Cloud 控制台。

  2. 前往「選單」>「資源清單」，然後點選「服務」以瀏覽您的雲端服務清單。

  3. 點擊表格中的該行。 這會開啟「資源」表格的側邊欄，您可以在其中查看 CRN 和實例 GUID。

  4. 點擊實例名稱的連結。 這將開啟您的 Key Protect 實例。

  5. 在「概覽」頁面上，找到「執行個體」區段。 您的實例 ID 和 CRN 已在此處以程式碼片段的形式列出。

使用 CLI 擷取實例 ID 和 CRN

您也可以取得您的 Key Protect 透過使用 IBM Cloud CLI。

  1. 請使用 IBM Cloud 登入 IBM Cloud CLI。

    ibmcloud login

    如果登入失敗，請執行 ibmcloud login --sso 指令再試一次。 該 --sso 當您使用聯邦身分識別登入時，此參數為必填項目。 如果使用這個選項，請前往 CLI 輸出中所列的鏈結，以產生一次性的通行碼。

  2. 選取包含 Key Protect 之佈建實例的帳戶、地區和資源群組。

  3. 取得可唯一識別您的 Key Protect 實例。

    ibmcloud resource service-instance <instance_name> --id

    請將 <instance_name> 替換為您為您的 Key Protect 實例。 如果您不知道您的執行個體名稱， 請執行 [ibmcloud resource service-instances指令](/docs/cli?topic=cli-ibmcloud_commands_resource#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 資源控制器 API， 然後將 JSON 輸出傳送至 jq 以擷取此值。

  1. 擷取 IBM Cloud IAM 存取記號。

  2. 呼叫 資源控制器 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