Service Management API 使用入门

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

注意： 如需使用 Cloud Endpoints 创建服务，则应参阅相关的 Endpoints 快速入门，以了解如何为 Cloud Endpoints 设置 Service Management API 并开始使用。

使用 gcloud 进行设置

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

3. 启用 Service Management API。

   启用 API

4. 安装 Google Cloud CLI。

5. 如需初始化 gcloud CLI，请运行以下命令：

   gcloud init

6. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

7. 启用 Service Management API。

   启用 API

8. 安装 Google Cloud CLI。

9. 如需初始化 gcloud CLI，请运行以下命令：

   gcloud init

设置为直接调用 API

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

初始设置

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

3. 如需初始化 gcloud CLI，请运行以下命令：

   gcloud init

4. 创建或选择 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   • 创建 Google Cloud 项目：

     gcloud projects create PROJECT_ID

     将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

   • 选择您创建的 Google Cloud 项目：

     gcloud config set project PROJECT_ID

     将 PROJECT_ID 替换为您的 Google Cloud 项目 名称。

5. Enable the Service Management API:

   gcloud services enable servicemanagement.googleapis.com

6. 向您的 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 替换为每个角色。
7. 安装 Google Cloud CLI。

8. 如需初始化 gcloud CLI，请运行以下命令：

   gcloud init

9. 创建或选择 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   • 创建 Google Cloud 项目：

     gcloud projects create PROJECT_ID

     将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

   • 选择您创建的 Google Cloud 项目：

     gcloud config set project PROJECT_ID

     将 PROJECT_ID 替换为您的 Google Cloud 项目 名称。

10. Enable the Service Management API:

    gcloud services enable servicemanagement.googleapis.com

11. 向您的 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. 为调用 Google REST API 定义一个方便的 shell 别名：

   $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   

2. 尝试列出可公开访问的服务：

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

   如果您看到一个服务列表，则设置成功。

后续步骤

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

1. 按照创建和删除服务来创建托管式服务。这将创建一个顶级托管式服务资源。

2. 按照管理服务配置中的说明提交服务配置，以描述该服务所使用的功能。

   注意：服务配置在提交后不会生效。您需要按照步骤 3 的操作来发布配置。

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