Cloud Run Admin API

Service: run.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 endpoints and all URIs below are relative to these service endpoints.

Global endpoint

https://run.googleapis.com
  • For v2:
    • This is the preferred endpoint for all methods.
    • Global list (e.g. using "-" as region) is not supported.
    • Regional endpoints are also supported.
  • For v1, this endpoint only supports Global List: use regional endpoints instead.

Regional endpoints

For v2, regional endpoints are supported, and region must match the location in the method path.
For v1, regional endpoints are required.

  • https://asia-east1-run.googleapis.com
  • https://asia-east2-run.googleapis.com
  • https://asia-northeast1-run.googleapis.com
  • https://asia-northeast2-run.googleapis.com
  • https://asia-northeast3-run.googleapis.com
  • https://asia-south1-run.googleapis.com
  • https://asia-south2-run.googleapis.com
  • https://asia-southeast1-run.googleapis.com
  • https://asia-southeast2-run.googleapis.com
  • https://australia-southeast1-run.googleapis.com
  • https://australia-southeast2-run.googleapis.com
  • https://europe-central2-run.googleapis.com
  • https://europe-north1-run.googleapis.com
  • https://europe-southwest1-run.googleapis.com
  • https://europe-west1-run.googleapis.com
  • https://europe-west2-run.googleapis.com
  • https://europe-west3-run.googleapis.com
  • https://europe-west4-run.googleapis.com
  • https://europe-west6-run.googleapis.com
  • https://europe-west8-run.googleapis.com
  • https://europe-west9-run.googleapis.com
  • https://northamerica-northeast1-run.googleapis.com
  • https://northamerica-northeast2-run.googleapis.com
  • https://southamerica-east1-run.googleapis.com
  • https://southamerica-west1-run.googleapis.com
  • https://us-central1-run.googleapis.com
  • https://us-east1-run.googleapis.com
  • https://us-east4-run.googleapis.com
  • https://us-east5-run.googleapis.com
  • https://us-south1-run.googleapis.com
  • https://us-west1-run.googleapis.com
  • https://us-west2-run.googleapis.com
  • https://us-west3-run.googleapis.com
  • https://us-west4-run.googleapis.com

REST Resource: v2.projects.locations.operations

Methods
delete DELETE /v2/{name}
Deletes a long-running operation.
get GET /v2/{name}
Gets the latest state of a long-running operation.
list GET /v2/{name}/operations
Lists operations that match the specified filter in the request.

REST Resource: v2.projects.locations.services

Methods
create POST /v2/{parent}/services
Creates a new Service in a given project and location.
delete DELETE /v2/{name}
Deletes a Service.
get GET /v2/{name}
Gets information about a Service.
getIamPolicy GET /v2/{resource}:getIamPolicy
Get the IAM Access Control policy currently in effect for the given Cloud Run Service.
list GET /v2/{parent}/services
List Services.
patch PATCH /v2/{service.name}
Updates a Service.
setIamPolicy POST /v2/{resource}:setIamPolicy
Sets the IAM Access control policy for the specified Service.
testIamPermissions POST /v2/{resource}:testIamPermissions
Returns permissions that a caller has on the specified Project.

REST Resource: v2.projects.locations.services.revisions

Methods
delete DELETE /v2/{name}
Delete a Revision.
get GET /v2/{name}
Gets information about a Revision.
list GET /v2/{parent}/revisions
List Revisions from a given Service, or from a given location.

REST Resource: v1.namespaces.authorizeddomains

Methods
list GET /apis/domains.cloudrun.com/v1/{parent}/authorizeddomains
List authorized domains.

REST Resource: v1.namespaces.configurations

Methods
get GET /apis/serving.knative.dev/v1/{name}
Get information about a configuration.
list GET /apis/serving.knative.dev/v1/{parent}/configurations
List configurations.

REST Resource: v1.namespaces.domainmappings

Methods
create POST /apis/domains.cloudrun.com/v1/{parent}/domainmappings
Create a new domain mapping.
delete DELETE /apis/domains.cloudrun.com/v1/{name}
Delete a domain mapping.
get GET /apis/domains.cloudrun.com/v1/{name}
Get information about a domain mapping.
list GET /apis/domains.cloudrun.com/v1/{parent}/domainmappings
List domain mappings.

REST Resource: v1.namespaces.executions

Methods
delete DELETE /apis/run.googleapis.com/v1/{name}
Delete an execution.
get GET /apis/run.googleapis.com/v1/{name}
Get information about an execution.
list GET /apis/run.googleapis.com/v1/{parent}/executions
List executions.

REST Resource: v1.namespaces.jobs

Methods
create POST /apis/run.googleapis.com/v1/{parent}/jobs
Create a job.
delete DELETE /apis/run.googleapis.com/v1/{name}
Delete a job.
get GET /apis/run.googleapis.com/v1/{name}
Get information about a job.
list GET /apis/run.googleapis.com/v1/{parent}/jobs
List jobs.
replaceJob PUT /apis/run.googleapis.com/v1/{name}
Replace a job.
run POST /apis/run.googleapis.com/v1/{name}:run
Trigger creation of a new execution of this job.

REST Resource: v1.namespaces.revisions

Methods
delete DELETE /apis/serving.knative.dev/v1/{name}
Delete a revision.
get GET /apis/serving.knative.dev/v1/{name}
Get information about a revision.
list GET /apis/serving.knative.dev/v1/{parent}/revisions
List revisions.

REST Resource: v1.namespaces.routes

Methods
get GET /apis/serving.knative.dev/v1/{name}
Get information about a route.
list GET /apis/serving.knative.dev/v1/{parent}/routes
List routes.

REST Resource: v1.namespaces.services

Methods
create POST /apis/serving.knative.dev/v1/{parent}/services
Create a service.
delete DELETE /apis/serving.knative.dev/v1/{name}
Delete a service.
get GET /apis/serving.knative.dev/v1/{name}
Get information about a service.
list GET /apis/serving.knative.dev/v1/{parent}/services
List services.
replaceService PUT /apis/serving.knative.dev/v1/{name}
Replace a service.

REST Resource: v1.namespaces.tasks

Methods
get GET /apis/run.googleapis.com/v1/{name}
Get information about a task.
list GET /apis/run.googleapis.com/v1/{parent}/tasks
List tasks.

REST Resource: v1.projects.locations

Methods
list GET /v1/{name}/locations
Lists information about the supported locations for this service.

REST Resource: v1.projects.locations.jobs

Methods
getIamPolicy GET /v1/{resource}:getIamPolicy
Get the IAM Access Control policy currently in effect for the given job.
setIamPolicy POST /v1/{resource}:setIamPolicy
Sets the IAM Access control policy for the specified job.
testIamPermissions POST /v1/{resource}:testIamPermissions
Returns permissions that a caller has on the specified job.

REST Resource: v1.projects.locations.services

Methods
getIamPolicy GET /v1/{resource}:getIamPolicy
Get the IAM Access Control policy currently in effect for the given Cloud Run service.
setIamPolicy POST /v1/{resource}:setIamPolicy
Sets the IAM Access control policy for the specified Service.
testIamPermissions POST /v1/{resource}:testIamPermissions
Returns permissions that a caller has on the specified Project.