- REST Resource: v2.projects.locations.operations
- REST Resource: v2.projects.locations.services
- REST Resource: v2.projects.locations.services.revisions
- REST Resource: v1.namespaces.authorizeddomains
- REST Resource: v1.namespaces.configurations
- REST Resource: v1.namespaces.domainmappings
- REST Resource: v1.namespaces.executions
- REST Resource: v1.namespaces.jobs
- REST Resource: v1.namespaces.revisions
- REST Resource: v1.namespaces.routes
- REST Resource: v1.namespaces.services
- REST Resource: v1.namespaces.tasks
- REST Resource: v1.projects.locations
- REST Resource: v1.projects.locations.jobs
- REST Resource: v1.projects.locations.services
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.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. |