Service Usage API

Enables services that service consumers want to use on Google Cloud Platform, lists the available or enabled services, or disables services that service consumers no longer use.

Service: serviceusage.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make 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 documents:

Service endpoint

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

  • https://serviceusage.googleapis.com

REST Resource: v2alpha

Methods
getEffectivePolicy GET /v2alpha/{name=*/*/effectivePolicy}
Get effective consumer policy for a resource, which contains enable rule information of consumer policies from the resource hierarchy.
testEnabled POST /v2alpha/{name=*/*}:testEnabled
Tests a value against the result of merging consumer policies in the resource hierarchy.

REST Resource: v2alpha.categories.categoryServices

Methods
list GET /v2alpha/{parent=*/*/categories/*}/categoryServices
List the services that belong to a given category.

REST Resource: v2alpha.consumerPolicies

Methods
get GET /v2alpha/{name=*/*/consumerPolicies/*}
Get the consumer policy of a resource.
patch PATCH /v2alpha/{consumerPolicy.name=*/*/consumerPolicies/*}
Update the consumer policy of a resource.

REST Resource: v2alpha.operations

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

REST Resource: v2alpha.services

Methods
batchGet GET /v2alpha/{parent=*/*}/services:batchGet
Get the details of a collection of services.
get GET /v2alpha/{name=*/*/services/*}
Get the details of a service.

REST Resource: v2alpha.services.ancestorGroups

Methods
list GET /v2alpha/{name=*/*/services/*}/ancestorGroups
List the ancestor groups that depend on the service.

REST Resource: v2alpha.services.apis

Methods
list GET /v2alpha/{parent=*/*/services/*}/apis
List APIs exposed by the given service.

REST Resource: v2alpha.services.groups

Methods
list GET /v2alpha/{parent=*/*/services/*}/groups
List service groups owned by the given service.

REST Resource: v2alpha.services.groups.descendantServices

Methods
list GET /v2alpha/{parent=*/*/services/*/groups/*}/descendantServices
List the services that belong to a given service group or transitively to any of the groups that are members of the service group.

REST Resource: v2alpha.services.groups.members

Methods
list GET /v2alpha/{parent=*/*/services/*/groups/*}/members
List members for the given service group.

REST Resource: v1beta1.operations

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

REST Resource: v1beta1.services

Methods
batchEnable
(deprecated)
POST /v1beta1/{parent=*/*}/services:batchEnable
Enables multiple services on a project.
disable
(deprecated)
POST /v1beta1/{name=*/*/services/*}:disable
Disables a service so that it can no longer be used with a project.
enable
(deprecated)
POST /v1beta1/{name=*/*/services/*}:enable
Enables a service so that it can be used with a project.
generateServiceIdentity POST /v1beta1/{parent=*/*/services/*}:generateServiceIdentity
Generates service identity for service.
get
(deprecated)
GET /v1beta1/{name=*/*/services/*}
Returns the service configuration and enabled state for a given service.
list
(deprecated)
GET /v1beta1/{parent=*/*}/services
Lists all services available to the specified project, and the current state of those services with respect to the project.

REST Resource: v1beta1.services.consumerQuotaMetrics

Methods
get GET /v1beta1/{name=*/*/services/*/consumerQuotaMetrics/*}
Retrieves a summary of quota information for a specific quota metric
importAdminOverrides POST /v1beta1/{parent=*/*/services/*}/consumerQuotaMetrics:importAdminOverrides
Creates or updates multiple admin overrides atomically, all on the same consumer, but on many different metrics or limits.
importConsumerOverrides POST /v1beta1/{parent=*/*/services/*}/consumerQuotaMetrics:importConsumerOverrides
Creates or updates multiple consumer overrides atomically, all on the same consumer, but on many different metrics or limits.
list GET /v1beta1/{parent=*/*/services/*}/consumerQuotaMetrics
Retrieves a summary of all quota information visible to the service consumer, organized by service metric.

REST Resource: v1beta1.services.consumerQuotaMetrics.limits

Methods
get GET /v1beta1/{name=*/*/services/*/consumerQuotaMetrics/*/limits/*}
Retrieves a summary of quota information for a specific quota limit.

REST Resource: v1beta1.services.consumerQuotaMetrics.limits.adminOverrides

Methods
create POST /v1beta1/{parent=*/*/services/*/consumerQuotaMetrics/*/limits/*}/adminOverrides
Creates an admin override.
delete DELETE /v1beta1/{name=*/*/services/*/consumerQuotaMetrics/*/limits/*/adminOverrides/*}
Deletes an admin override.
list GET /v1beta1/{parent=*/*/services/*/consumerQuotaMetrics/*/limits/*}/adminOverrides
Lists all admin overrides on this limit.
patch PATCH /v1beta1/{name=*/*/services/*/consumerQuotaMetrics/*/limits/*/adminOverrides/*}
Updates an admin override.

REST Resource: v1beta1.services.consumerQuotaMetrics.limits.consumerOverrides

Methods
create POST /v1beta1/{parent=*/*/services/*/consumerQuotaMetrics/*/limits/*}/consumerOverrides
Creates a consumer override.
delete DELETE /v1beta1/{name=*/*/services/*/consumerQuotaMetrics/*/limits/*/consumerOverrides/*}
Deletes a consumer override.
list GET /v1beta1/{parent=*/*/services/*/consumerQuotaMetrics/*/limits/*}/consumerOverrides
Lists all consumer overrides on this limit.
patch PATCH /v1beta1/{name=*/*/services/*/consumerQuotaMetrics/*/limits/*/consumerOverrides/*}
Updates a consumer override.

REST Resource: v1.operations

Methods
cancel POST /v1/{name=operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=operations/**}
Deletes a long-running operation.
get GET /v1/{name=operations/*}
Gets the latest state of a long-running operation.
list GET /v1/operations
Lists operations that match the specified filter in the request.

REST Resource: v1.services

Methods
batchEnable POST /v1/{parent=*/*}/services:batchEnable
Enable multiple services on a project.
batchGet GET /v1/{parent=*/*}/services:batchGet
Returns the service configurations and enabled states for a given list of services.
disable POST /v1/{name=*/*/services/*}:disable
Disable a service so that it can no longer be used with a project.
enable POST /v1/{name=*/*/services/*}:enable
Enable a service so that it can be used with a project.
get GET /v1/{name=*/*/services/*}
Returns the service configuration and enabled state for a given service.
list GET /v1/{parent=*/*}/services
List all services available to the specified project, and the current state of those services with respect to the project.