获取您的实例 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 命令 命令，以获取 您在所选区域中配置的实例名称列表。

    以下截断的示例显示了 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 检索实例标识

您可能要以编程方式检索实例标识，以帮助您构建并连接应用程序。 您可以拨打该 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 请求， 以获取您在所选区域中配置的实例名称列表。

    以下输出显示实例标识示例：

    42454b3b-5b06-407b-a4b3-34d9ef323901