This page describes how to manage the lifecycles of
managed services using the Google Cloud CLI
gcloud endpoints services
For advanced use cases, you can use the Service Management API to manage services programmatically. For more information, see Getting Started with the Service Management API
A managed service is a simple resource that logically represents a service integrated with Service Infrastructure, such as Gmail API and Spanner API. A managed service itself has only two immutable properties, a service name and a producer project, but the implementation of a managed service can provide a wide range of functionality. For example, Cloud Storage API provides planet-scale object storage for millions of developers and enterprises.
A managed service has a set of
a history of immutable
and a history of immutable
The service configurations referenced by the latest service rollout represents
the current state of the service, which covers all aspects of the service, from
the display name to metrics definitions to rate limits. For the specification,
We will describe how to create and manage your service lifecycles in this page. For more information about the service management, see How-to Guides.
Creating a service
To create a service, you need to complete the following steps.
Install and initialize gcloud CLI on your computer.
Create a dedicated producer project to host your service. A dedicated project provides the best security and isolation for your service. It also allows you to transfer the ownership of your service to another team or even another company.
Enable the Service Management API and Service Control API for your project.
Enable Cloud Billing for your project. To integrate your service with Service Infrastructure, you will depend on several paid Google Cloud products, including the Service Control API, Cloud Logging API, and Cloud Monitoring API.
Prepare a simple service configuration yaml file for your service as follows:
# 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
gcloudcommand to create your service by deploying a blank service configuration:
gcloud endpoints services deploy endpointsapis.yaml
The service creation process takes about a minute. After that, you should be able to see your service listed on the Endpoints page in Google Cloud console.
To list services in a project, you can use the following command:
gcloud endpoints services list --project endpointsapis
Describing a service
To describe a service and its configuration, you can use the following command:
gcloud endpoints services describe endpointsapis.appspot.com
Deleting a service
If you no longer need a service, you can delete it using the following command:
gcloud endpoints services delete endpointsapis.appspot.com
NOTE: Every service has a mandatory 30-day deletion retention.
Undeleting a service
You can undelete a service within its retention window using the following command:
gcloud endpoints services undelete endpointsapis.appspot.com
The Service Management API uses a declarative model for service management. After the service is created, you need to push immutable service configurations and service rollouts to reach the desired state of your service. Your service configurations are used to configure Google Cloud infrastructure services to support your service, including Cloud Billing, Cloud Logging, Cloud Monitoring, and Identity and Access Management.
For more information about service configurations, see Managing Service Configurations. For more information about service rollouts, see Managing Service Rollouts.