Service Management API

Google Service Management allows service producers to publish their services on Google Cloud Platform so that they can be discovered and used by service consumers.

Service: servicemanagement.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://servicemanagement.googleapis.com

REST Resource: v1.operations

Methods
get GET /v1/{name=operations/**}
Gets the latest state of a long-running operation.
list GET /v1/operations
Lists service operations that match the specified filter in the request.

REST Resource: v1.services

Methods
create POST /v1/services
Creates a new managed service.
delete DELETE /v1/services/{serviceName}
Deletes a managed service.
disable
(deprecated)
POST /v1/services/{serviceName}:disable
Disables a service for a project, so it can no longer be be used for the project.
enable
(deprecated)
POST /v1/services/{serviceName}:enable
Enables a service for a project, so it can be used for the project.
generateConfigReport POST /v1/services:generateConfigReport

Generates and returns a report (errors, warnings and changes from existing configurations) associated with GenerateConfigReportRequest.new_value

If GenerateConfigReportRequest.old_value is specified, GenerateConfigReportRequest will contain a single ChangeReport based on the comparison between GenerateConfigReportRequest.new_value and GenerateConfigReportRequest.old_value.

get GET /v1/services/{serviceName}
Gets a managed service.
getConfig GET /v1/services/{serviceName}/config
Gets a service configuration (version) for a managed service.
getIamPolicy POST /v1/{resource=services/*}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1/services
Lists managed services.
setIamPolicy POST /v1/{resource=services/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=services/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.
undelete POST /v1/services/{serviceName}:undelete
Revives a previously deleted managed service.

REST Resource: v1.services.configs

Methods
create POST /v1/services/{serviceName}/configs
Creates a new service configuration (version) for a managed service.
get GET /v1/services/{serviceName}/configs/{configId}
Gets a service configuration (version) for a managed service.
list GET /v1/services/{serviceName}/configs
Lists the history of the service configuration for a managed service, from the newest to the oldest.
submit POST /v1/services/{serviceName}/configs:submit
Creates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification).

REST Resource: v1.services.consumers

Methods
getIamPolicy POST /v1/{resource=services/*/consumers/*}:getIamPolicy
Gets the access control policy for a resource.
setIamPolicy POST /v1/{resource=services/*/consumers/*}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=services/*/consumers/*}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.services.rollouts

Methods
create POST /v1/services/{serviceName}/rollouts
Creates a new service configuration rollout.
get GET /v1/services/{serviceName}/rollouts/{rolloutId}
Gets a service configuration rollout.
list GET /v1/services/{serviceName}/rollouts
Lists the history of the service configuration rollouts for a managed service, from the newest to the oldest.