本页介绍了如何使用 Google Cloud CLI gcloud endpoints services
命令管理托管式服务的生命周期。
对于高级用例,您可以使用 Service Management API 以编程方式管理服务。如需了解详情,请参阅 Service Management API 使用入门
简介
托管式服务是一种简单的资源,用于以逻辑方式表示与 Service Infrastructure 集成的服务,例如 Gmail API 和 Spanner API。托管式服务本身只有两个不可变属性(服务名称和生产者项目),但托管式服务的实现可以提供范围广泛的各种功能。例如,Cloud Storage API 可为数百万开发者和企业提供全球级对象存储。
托管式服务具有一组服务使用方、不可变服务配置历史记录以及不可变服务发布历史记录。最新服务发布引用的服务配置表示服务的当前状态,其中包括服务所有方面的内容(如显示名称、指标定义、速率限制等)。如需了解相关规范,请参阅 google.api.Service
。
我们将在此页面中介绍如何创建和管理您的服务生命周期。如需详细了解服务管理,请参阅方法指南。
创建服务
要创建服务,您需要完成以下步骤。
在计算机上安装并初始化 gcloud CLI。
创建一个专用生产者项目以托管您的服务。专用项目可为您的服务提供最佳安全性和隔离性。您还可以将服务的所有权转让给其他团队,甚至是其他公司。
为您的项目启用 Service Management API 和 Service Control API。
为您的项目启用 Cloud Billing。要将您的服务与 Service Infrastructure 集成,您需要依赖于几种付费 Google Cloud 产品,包括 Service Control API、Cloud Logging API 和 Cloud Monitoring API。
为您的服务准备简单的服务配置 yaml 文件,如下所示:
# Filename: endpointsapis.yaml type: google.api.Service config_version: 3 # Update the next line to use your own service name. name: endpointsapis.appspot.com # Update the next line to use your own producer project id. producer_project_id: endpointsapis
运行
gcloud
命令以通过部署空白服务配置来创建服务:gcloud endpoints services deploy endpointsapis.yaml
服务创建过程大约需要一分钟。之后,您应该可以在 Google Cloud 控制台中的 Endpoints 页面上看到您的服务。
列出服务
要列出项目中的服务,您可以使用以下命令:
gcloud endpoints services list --project endpointsapis
描述服务
要描述服务及其配置,您可以使用以下命令:
gcloud endpoints services describe endpointsapis.appspot.com
删除服务
如果您不再需要某项服务,可以使用以下命令将其删除:
gcloud endpoints services delete endpointsapis.appspot.com
注意:每项服务都具有 30 天的删除保留期。
取消删除服务
您可以使用以下命令在服务保留期限内取消删除服务:
gcloud endpoints services undelete endpointsapis.appspot.com
后续步骤
Service Management API 使用声明式模型进行服务管理。创建服务后,您需要推送不可变服务配置和服务发布,以实现所需的服务状态。您的服务配置用于配置 Google Cloud 基础架构服务以为您的服务提供支持,这些基础架构服务包括 Cloud Billing、Cloud Logging、Cloud Monitoring 和 Identity and Access Management。
如需详细了解服务配置,请参阅管理服务配置。如需详细了解服务发布,请参阅管理服务发布。