Service Management API 使用入门

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

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

使用 gcloud 进行设置

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Enable the Service Management API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

3. Install the Google Cloud CLI.

4. 配置 gcloud CLI 以使用您的联合身份。

   如需了解详情，请参阅使用联合身份登录 gcloud CLI。

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

   gcloud init

   设置为直接调用 API

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

   初始设置

   1. Install the Google Cloud CLI.

   2. 配置 gcloud CLI 以使用您的联合身份。

      如需了解详情，请参阅使用联合身份登录 gcloud CLI。

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

      gcloud init

   4. Create or select a Google Cloud project.

      Roles required to select or create a project

      • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
      • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
      Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

      • Create a Google Cloud project:

        gcloud projects create PROJECT_ID

        Replace PROJECT_ID with a name for the Google Cloud project you are creating.

      • Select the Google Cloud project that you created:

        gcloud config set project PROJECT_ID

        Replace PROJECT_ID with your Google Cloud project name.

   5. Enable the Service Management API:

      Roles required to enable APIs

      To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

      gcloud services enable servicemanagement.googleapis.com

   6. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin

      gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

      Replace the following:

      • PROJECT_ID: Your project ID.
      • USER_IDENTIFIER: The identifier for your user account. For examples, see Represent workforce pool users in IAM policies.
      • ROLE: The IAM role that you grant to your user account.

   用 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. 按照发布服务配置中的说明来发布您的服务配置。