IBM Cloud Docs
检索实例标识

检索实例标识

使用用户界面、CLI 或 API 获取实例 ID。

您可以将单个 IBM Cloud® DNS Services 服务实例作为目标进行操作,方法是在针对该服务的 API 请求中包含其唯一标识或实例标识。

在控制台中检索实例 ID

可以通过导航到 DNS Services 资源列表来查看与 IBM Cloud 服务实例关联的实例标识。

  1. 登录IBM Cloud控制台
  2. 转到菜单 > 资源列表,然后单击服务浏览云服务列表。
  3. 单击描述 DNS Services 服务实例的表行。
  4. 从服务详细视图中,复制 GUID 值。 此 GUID 值表示用于唯一标识 DNS Services 服务实例的实例标识。

从 CLI 获取实例 ID

您还可以使用 IBM Cloud CLI 获取服务实例的实例 ID。

  1. 使用 "IBM CloudCLI IBM Cloud。

    ibmcloud login
    

    如果登录失败,请运行 ibmcloud login --sso 命令重试。 使用联合标识登录时需要 --sso 参数。 如果使用此选项,请转至 CLI 输出中列出的链接以生成一次性密码。

  2. 选择包含供应的 DNS Services 实例的帐户、区域和资源组。

  3. 检索唯一标识 DNS Services 服务实例的云资源名称 (CRN)。

    ibmcloud resource service-instance <instance_name> --id
    

    <instance_name> 替换为分配给 DNS Services 服务实例的唯一别名。 以下截断的示例显示了 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。

使用应用程序接口检索实例 ID

您可能要以编程方式检索实例标识,以帮助您构建并连接应用程序。 您可以调用 IBM Cloud Resource Controller 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> 替换为分配给 DNS Services 服务实例的唯一别名。 以下输出显示实例标识示例:

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