Service Management API 使用入门

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页描述如何设置开发环境来使用 Service Management API。使用 Service Management API 的最简单方法(而不仅仅是使用 Google Cloud Console 网页界面)以及我们建议的大多数操作用例是通过 gcloud 命令行界面执行。如果您需要针对 Service Management API 进行编程,则可以使用我们提供的某一客户端库。若要试用该 API,您可以按照下面的备用设置说明进行操作,并使用 curl 命令来使用该 API,而无需设置完整的应用开发环境。

使用 gcloud 进行设置

  1. 登录您的 Google Cloud 帐号。如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  3. 启用 Service Management API。

    启用 API

  4. 安装初始化 Google Cloud CLI。
  5. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  6. 启用 Service Management API。

    启用 API

  7. 安装初始化 Google Cloud CLI。

设置为直接调用 API

本节描述了通过使用 curl 命令的 Service Management API 设置本地环境以进行试验所必需的基本步骤。这种设置适用于需要针对 Service Management API 进行编程的开发者。

初始设置

  1. 登录您的 Google Cloud 帐号。如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 安装初始化 Google Cloud CLI。
  3. 创建或选择 Google Cloud 项目。

    • 创建 Cloud 项目:

      gcloud projects create PROJECT_ID
    • 选择您创建的 Cloud 项目:

      gcloud config set project PROJECT_ID
  4. Enable the Service Management API:

    gcloud services enable servicemanagement.googleapis.com
  5. 向您的 Google 帐号授予角色。对以下每个 IAM 角色运行以下命令一次: roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • PROJECT_ID 替换为您的项目 ID。
    • EMAIL_ADDRESS 替换为您的电子邮件地址。
    • ROLE 替换为每个角色。
  6. 安装初始化 Google Cloud CLI。
  7. 创建或选择 Google Cloud 项目。

    • 创建 Cloud 项目:

      gcloud projects create PROJECT_ID
    • 选择您创建的 Cloud 项目:

      gcloud config set project PROJECT_ID
  8. Enable the Service Management API:

    gcloud services enable servicemanagement.googleapis.com
  9. 向您的 Google 帐号授予角色。对以下每个 IAM 角色运行以下命令一次: roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • PROJECT_ID 替换为您的项目 ID。
    • EMAIL_ADDRESS 替换为您的电子邮件地址。
    • ROLE 替换为每个角色。

用 curl 进行测试

  1. 定义一个方便的 shell 别名,以便调用 Google REST API:

    $ alias gcurl='curl -H "Authentication: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
  2. 尝试列出可公开访问的服务:

    $ gcurl https://servicemanagement.googleapis.com/v1/services
    

    如果您看到服务列表,则说明设置成功。

后续步骤

如果您要创建托管式服务但没有使用 Cloud Endpoints,请按照下列步骤操作:

  1. 按照创建和删除服务来创建托管式服务。这将创建一个顶级托管式服务资源。
  2. 按照管理服务配置中的说明提交服务配置,以描述该服务所使用的功能。

  3. 按照发布服务配置中的说明来发布您的服务配置。