openapi-directory/api/googleapis.com/run.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","servers":[{"url":"https://run.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"Deploy and manage user provided container images that scale automatically based on incoming requests. The Cloud Run Admin API v1 follows the Knative Serving API specification, while v2 is aligned with Google Cloud AIP-based API standards, as described in https://google.aip.dev/.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Cloud Run Admin API","version":"v2","x-apiClientRegistration":{"url":"https://console.developers.google.com"},"x-apisguru-categories":["analytics","media"],"x-logo":{"url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"},"x-origin":[{"format":"google","url":"https://run.googleapis.com/$discovery/rest?version=v2","version":"v1"}],"x-preferred":true,"x-providerName":"googleapis.com","x-serviceName":"run"},"externalDocs":{"url":"https://cloud.google.com/run/"},"tags":[{"name":"projects"}],"paths":{"/v2/{name}":{"delete":{"description":"Deletes a Revision.","operationId":"run.projects.locations.services.revisions.delete","parameters":[{"description":"Required. The name of the Revision to delete. Format: projects/{project}/locations/{location}/services/{service}/revisions/{revision}","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"A system-generated fingerprint for this version of the resource. This may be used to detect modification conflict during updates.","in":"query","name":"etag","schema":{"type":"string"}},{"description":"Indicates that the request should be validated without actually deleting any resources.","in":"query","name":"validateOnly","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningOperation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"get":{"description":"Gets information about a Revision.","operationId":"run.projects.locations.services.revisions.get","parameters":[{"description":"Required. The full name of the Revision. Format: projects/{project}/locations/{location}/services/{service}/revisions/{revision}","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2Revision"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"patch":{"description":"Updates a Service.","operationId":"run.projects.locations.services.patch","parameters":[{"description":"The fully qualified name of this Service. In CreateServiceRequest, this field is ignored, and instead composed from CreateServiceRequest.parent and CreateServiceRequest.service_id. Format: projects/{project}/locations/{location}/services/{service_id}","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"If set to true, and if the Service does not exist, it will create a new one. The caller must have 'run.services.create' permissions if this is set to true and the Service does not exist.","in":"query","name":"allowMissing","schema":{"type":"boolean"}},{"description":"Indicates that the request should be validated and default values populated, without persisting the request or updating any resources.","in":"query","name":"validateOnly","schema":{"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2Service"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningOperation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}},"/v2/{name}/operations":{"get":{"description":"Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.","operationId":"run.projects.locations.operations.list","parameters":[{"description":"Required. To query for all of the operations for a project.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Optional. A filter for matching the completed or in-progress operations. The supported formats of *filter* are: To query for only completed operations: done:true To query for only ongoing operations: done:false Must be empty to query for all of the latest operations for the given parent project.","in":"query","name":"filter","schema":{"type":"string"}},{"description":"The maximum number of records that should be returned. Requested page size cannot exceed 100. If not set or set to less than or equal to 0, the default page size is 100. .","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token identifying which result to start with, which is returned by a previous list call.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningListOperationsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2/{name}:cancel":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Cancels an Execution.","operationId":"run.projects.locations.jobs.executions.cancel","parameters":[{"description":"Required. The name of the Execution to cancel. Format: `projects/{project}/locations/{location}/jobs/{job}/executions/{execution}`, where `{project}` can be project id or number.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2CancelExecutionRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningOperation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}},"/v2/{name}:run":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Triggers creation of a new Execution of this Job.","operationId":"run.projects.locations.jobs.run","parameters":[{"description":"Required. The full name of the Job. Format: projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or number.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2RunJobRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningOperation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}},"/v2/{name}:wait":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.","operationId":"run.projects.locations.operations.wait","parameters":[{"description":"The name of the operation resource to wait on.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningWaitOperationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningOperation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}},"/v2/{parent}/executions":{"get":{"description":"Lists Executions from a Job.","operationId":"run.projects.locations.jobs.executions.list","parameters":[{"description":"Required. The Execution from which the Executions should be listed. To list all Executions across Jobs, use \"-\" instead of Job name. Format: `projects/{project}/locations/{location}/jobs/{job}`, where `{project}` can be project id or number.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Maximum number of Executions to return in this call.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A page token received from a previous call to ListExecutions. All other parameters must match.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"If true, returns deleted (but unexpired) resources along with active ones.","in":"query","name":"showDeleted","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2ListExecutionsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2/{parent}/jobs":{"get":{"description":"Lists Jobs.","operationId":"run.projects.locations.jobs.list","parameters":[{"description":"Required. The location and project to list resources on. Format: projects/{project}/locations/{location}, where {project} can be project id or number.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Maximum number of Jobs to return in this call.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A page token received from a previous call to ListJobs. All other parameters must match.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"If true, returns deleted (but unexpired) resources along with active ones.","in":"query","name":"showDeleted","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2ListJobsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a Job.","operationId":"run.projects.locations.jobs.create","parameters":[{"description":"Required. The location and project in which this Job should be created. Format: projects/{project}/locations/{location}, where {project} can be project id or number.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Required. The unique identifier for the Job. The name of the job becomes {parent}/jobs/{job_id}.","in":"query","name":"jobId","schema":{"type":"string"}},{"description":"Indicates that the request should be validated and default values populated, without persisting the request or creating any resources.","in":"query","name":"validateOnly","schema":{"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2Job"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningOperation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}},"/v2/{parent}/revisions":{"get":{"description":"Lists Revisions from a given Service, or from a given location.","operationId":"run.projects.locations.services.revisions.list","parameters":[{"description":"Required. The Service from which the Revisions should be listed. To list all Revisions across Services, use \"-\" instead of Service name. Format: projects/{project}/locations/{location}/services/{service}","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Maximum number of revisions to return in this call.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A page token received from a previous call to ListRevisions. All other parameters must match.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"If true, returns deleted (but unexpired) resources along with active ones.","in":"query","name":"showDeleted","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2ListRevisionsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2/{parent}/services":{"get":{"description":"Lists Services.","operationId":"run.projects.locations.services.list","parameters":[{"description":"Required. The location and project to list resources on. Location must be a valid Google Cloud region, and cannot be the \"-\" wildcard. Format: projects/{project}/locations/{location}, where {project} can be project id or number.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Maximum number of Services to return in this call.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A page token received from a previous call to ListServices. All other parameters must match.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"If true, returns deleted (but unexpired) resources along with active ones.","in":"query","name":"showDeleted","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2ListServicesResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a new Service in a given project and location.","operationId":"run.projects.locations.services.create","parameters":[{"description":"Required. The location and project in which this service should be created. Format: projects/{project}/locations/{location}, where {project} can be project id or number. Only lowercase characters, digits, and hyphens.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Required. The unique identifier for the Service. It must begin with letter, and cannot end with hyphen; must contain fewer than 50 characters. The name of the service becomes {parent}/services/{service_id}.","in":"query","name":"serviceId","schema":{"type":"string"}},{"description":"Indicates that the request should be validated and default values populated, without persisting the request or creating any resources.","in":"query","name":"validateOnly","schema":{"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2Service"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLongrunningOperation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}},"/v2/{parent}/tasks":{"get":{"description":"Lists Tasks from an Execution of a Job.","operationId":"run.projects.locations.jobs.executions.tasks.list","parameters":[{"description":"Required. The Execution from which the Tasks should be listed. To list all Tasks across Executions of a Job, use \"-\" instead of Execution name. To list all Tasks across Jobs, use \"-\" instead of Job name. Format: projects/{project}/locations/{location}/jobs/{job}/executions/{execution}","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Maximum number of Tasks to return in this call.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A page token received from a previous call to ListTasks. All other parameters must match.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"If true, returns deleted (but unexpired) resources along with active ones.","in":"query","name":"showDeleted","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCloudRunV2ListTasksResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2/{resource}:getIamPolicy":{"get":{"description":"Gets the IAM Access Control policy currently in effect for the given Cloud Run Service. This result does not include any inherited policies.","operationId":"run.projects.locations.services.getIamPolicy","parameters":[{"description":"REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.","in":"path","name":"resource","required":true,"schema":{"type":"string"}},{"description":"Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).","in":"query","name":"options.requestedPolicyVersion","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleIamV1Policy"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2/{resource}:setIamPolicy":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Sets the IAM Access control policy for the specified Service. Overwrites any existing policy.","operationId":"run.projects.locations.services.setIamPolicy","parameters":[{"description":"REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.","in":"path","name":"resource","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleIamV1SetIamPolicyRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleIamV1Policy"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}},"/v2/{resource}:testIamPermissions":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Returns permissions that a caller has on the specified Project. There are no permissions required for making this API call.","operationId":"run.projects.locations.services.testIamPermissions","parameters":[{"description":"REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.","in":"path","name":"resource","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleIamV1TestIamPermissionsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleIamV1TestIamPermissionsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/cloud-platform"],"Oauth2c":["https://www.googleapis.com/auth/cloud-platform"]}],"tags":["projects"]}}},"components":{"parameters":{"_.xgafv":{"description":"V1 error format.","in":"query","name":"$.xgafv","schema":{"enum":["1","2"],"type":"string"}},"access_token":{"description":"OAuth access token.","in":"query","name":"access_token","schema":{"type":"string"}},"alt":{"description":"Data format for response.","in":"query","name":"alt","schema":{"enum":["json","media","proto"],"type":"string"}},"callback":{"description":"JSONP","in":"query","name":"callback","schema":{"type":"string"}},"fields":{"description":"Selector specifying which fields to include in a partial response.","in":"query","name":"fields","schema":{"type":"string"}},"key":{"description":"API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.","in":"query","name":"key","schema":{"type":"string"}},"oauth_token":{"description":"OAuth 2.0 token for the current user.","in":"query","name":"oauth_token","schema":{"type":"string"}},"prettyPrint":{"description":"Returns response with indentations and line breaks.","in":"query","name":"prettyPrint","schema":{"type":"boolean"}},"quotaUser":{"description":"Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.","in":"query","name":"quotaUser","schema":{"type":"string"}},"uploadType":{"description":"Legacy upload protocol for media (e.g. \"media\", \"multipart\").","in":"query","name":"uploadType","schema":{"type":"string"}},"upload_protocol":{"description":"Upload protocol for media (e.g. \"raw\", \"multipart\").","in":"query","name":"upload_protocol","schema":{"type":"string"}}},"schemas":{"GoogleCloudRunV2BinaryAuthorization":{"description":"Settings for Binary Authorization feature.","properties":{"breakglassJustification":{"description":"If present, indicates to use Breakglass using this justification. If use_default is False, then it must be empty. For more information on breakglass, see https://cloud.google.com/binary-authorization/docs/using-breakglass","type":"string"},"useDefault":{"description":"If True, indicates to use the default project's binary authorization policy. If False, binary authorization will be disabled.","type":"boolean"}},"type":"object"},"GoogleCloudRunV2CancelExecutionRequest":{"description":"Request message for deleting an Execution.","properties":{"etag":{"description":"A system-generated fingerprint for this version of the resource. This may be used to detect modification conflict during updates.","type":"string"},"validateOnly":{"description":"Indicates that the request should be validated without actually cancelling any resources.","type":"boolean"}},"type":"object"},"GoogleCloudRunV2CloudSqlInstance":{"description":"Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run.","properties":{"instances":{"description":"The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance}","items":{"type":"string"},"type":"array"}},"type":"object"},"GoogleCloudRunV2Condition":{"description":"Defines a status condition for a resource.","properties":{"executionReason":{"description":"A reason for the execution condition.","enum":["EXECUTION_REASON_UNDEFINED","JOB_STATUS_SERVICE_POLLING_ERROR","NON_ZERO_EXIT_CODE","CANCELLED","CANCELLING","DELETED"],"type":"string"},"lastTransitionTime":{"description":"Last time the condition transitioned from one status to another.","format":"google-datetime","type":"string"},"message":{"description":"Human readable message indicating details about the current status.","type":"string"},"reason":{"description":"A common (service-level) reason for this condition.","enum":["COMMON_REASON_UNDEFINED","UNKNOWN","REVISION_FAILED","PROGRESS_DEADLINE_EXCEEDED","CONTAINER_MISSING","CONTAINER_PERMISSION_DENIED","CONTAINER_IMAGE_UNAUTHORIZED","CONTAINER_IMAGE_AUTHORIZATION_CHECK_FAILED","ENCRYPTION_KEY_PERMISSION_DENIED","ENCRYPTION_KEY_CHECK_FAILED","SECRETS_ACCESS_CHECK_FAILED","WAITING_FOR_OPERATION","IMMEDIATE_RETRY","POSTPONED_RETRY","INTERNAL"],"type":"string"},"revisionReason":{"description":"A reason for the revision condition.","enum":["REVISION_REASON_UNDEFINED","PENDING","RESERVE","RETIRED","RETIRING","RECREATING","HEALTH_CHECK_CONTAINER_ERROR","CUSTOMIZED_PATH_RESPONSE_PENDING","MIN_INSTANCES_NOT_PROVISIONED","ACTIVE_REVISION_LIMIT_REACHED","NO_DEPLOYMENT","HEALTH_CHECK_SKIPPED","MIN_INSTANCES_WARMING"],"type":"string"},"severity":{"description":"How to interpret failures of this condition, one of Error, Warning, Info","enum":["SEVERITY_UNSPECIFIED","ERROR","WARNING","INFO"],"type":"string"},"state":{"description":"State of the condition.","enum":["STATE_UNSPECIFIED","CONDITION_PENDING","CONDITION_RECONCILING","CONDITION_FAILED","CONDITION_SUCCEEDED"],"type":"string"},"type":{"description":"type is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * \"Ready\": True when the Resource is ready.","type":"string"}},"type":"object"},"GoogleCloudRunV2Container":{"description":"A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime.","properties":{"args":{"description":"Arguments to the entrypoint. The docker image's CMD is used if this is not provided.","items":{"type":"string"},"type":"array"},"command":{"description":"Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.","items":{"type":"string"},"type":"array"},"dependsOn":{"description":"Names of the containers that must start before this container.","items":{"type":"string"},"type":"array"},"env":{"description":"List of environment variables to set in the container.","items":{"$ref":"#/components/schemas/GoogleCloudRunV2EnvVar"},"type":"array"},"image":{"description":"Required. Name of the container image in Dockerhub, Google Artifact Registry, or Google Container Registry. If the host is not provided, Dockerhub is assumed.","type":"string"},"livenessProbe":{"$ref":"#/components/schemas/GoogleCloudRunV2Probe","description":"Periodic probe of container liveness. Container will be restarted if the probe fails."},"name":{"description":"Name of the container specified as a DNS_LABEL (RFC 1123).","type":"string"},"ports":{"description":"List of ports to expose from the container. Only a single port can be specified. The specified ports must be listening on all interfaces (0.0.0.0) within the container to be accessible. If omitted, a port number will be chosen and passed to the container through the PORT environment variable for the container to listen on.","items":{"$ref":"#/components/schemas/GoogleCloudRunV2ContainerPort"},"type":"array"},"resources":{"$ref":"#/components/schemas/GoogleCloudRunV2ResourceRequirements","description":"Compute Resource requirements by this container."},"startupProbe":{"$ref":"#/components/schemas/GoogleCloudRunV2Probe","description":"Startup probe of application within the container. All other probes are disabled if a startup probe is provided, until it succeeds. Container will not be added to service endpoints if the probe fails."},"volumeMounts":{"description":"Volume to mount into the container's filesystem.","items":{"$ref":"#/components/schemas/GoogleCloudRunV2VolumeMount"},"type":"array"},"workingDir":{"description":"Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image.","type":"string"}},"type":"object"},"GoogleCloudRunV2ContainerOverride":{"description":"Per-container override specification.","properties":{"args":{"description":"Optional. Arguments to the entrypoint. Will replace existing args for override.","items":{"type":"string"},"type":"array"},"clearArgs":{"description":"Optional. True if the intention is to clear out existing args list.","type":"boolean"},"env":{"description":"List of environment variables to set in the container. Will be merged with existing env for override.","items":{"$ref":"#/components/schemas/GoogleCloudRunV2EnvVar"},"type":"array"},"name":{"description":"The name of the container specified as a DNS_LABEL.","type":"string"}},"type":"object"},"GoogleCloudRunV2ContainerPort":{"description":"ContainerPort represents a network port in a single container.","properties":{"containerPort":{"description":"Port number the container listens on. This must be a valid TCP port number, 0 < container_port < 65536.","format":"int32","type":"integer"},"name":{"description":"If specified, used to specify which protocol to use. Allowed values are \"http1\" and \"h2c\".","type":"string"}},"type":"object"},"GoogleCloudRunV2EmptyDirVolumeSource":{"description":"In memory (tmpfs) ephemeral storage. It is ephemeral in the sense that when the sandbox is taken down, the data is destroyed with it (it does not persist across sandbox runs).","properties":{"medium":{"description":"The medium on which the data is stored. Acceptable values today is only MEMORY or none. When none, the default will currently be backed by memory but could change over time. +optional","enum":["MEDIUM_UNSPECIFIED","MEMORY"],"type":"string"},"sizeLimit":{"description":"Limit on the storage usable by this EmptyDir volume. The size limit is also applicable for memory medium. The maximum usage on memory medium EmptyDir would be the minimum value between the SizeLimit specified here and the sum of memory limits of all containers. The default is nil which means that the limit is undefined. More info: https://cloud.google.com/run/docs/configuring/in-memory-volumes#configure-volume. Info in Kubernetes: https://kubernetes.io/docs/concepts/storage/volumes/#emptydir","type":"string"}},"type":"object"},"GoogleCloudRunV2EnvVar":{"description":"EnvVar represents an environment variable present in a Container.","properties":{"name":{"description":"Required. Name of the environment variable. Must not exceed 32768 characters.","type":"string"},"value":{"description":"Variable references $(VAR_NAME) are expanded using the previous defined environment variables in the container and any route environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to \"\", and the maximum length is 32768 bytes.","type":"string"},"valueSource":{"$ref":"#/components/schemas/GoogleCloudRunV2EnvVarSource","description":"Source for the environment variable's value."}},"type":"object"},"GoogleCloudRunV2EnvVarSource":{"description":"EnvVarSource represents a source for the value of an EnvVar.","properties":{"secretKeyRef":{"$ref":"#/components/schemas/GoogleCloudRunV2SecretKeySelector","description":"Selects a secret and a specific version from Cloud Secret Manager."}},"type":"object"},"GoogleCloudRunV2Execution":{"description":"Execution represents the configuration of a single execution. A execution an immutable resource that references a container image which is run to completion.","properties":{"annotations":{"additionalProperties":{"type":"string"},"description":"Output only. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.","readOnly":true,"type":"object"},"cancelledCount":{"description":"Output only. The number of tasks which reached phase Cancelled.","format":"int32","readOnly":true,"type":"integer"},"completionTime":{"description":"Output only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.","format":"google-datetime","readOnly":true,"type":"string"},"conditions":{"description":"Output only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.","items":{"$ref":"#/components/schemas/GoogleCloudRunV2Condition"},"readOnly":true,"type":"array"},"createTime":{"description":"Output only. Represents time when the execution was acknowledged by the execution controller. It is not guaranteed to be set in happens-before order across separate operations.","format":"google-datetime","readOnly":true,"type":"string"},"deleteTime":{"description":"Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.","format":"google-datetime","readOnly":true,"type":"string"},"etag":{"description":"Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.","readOnly":true,"type":"string"},"expireTime":{"description":"Output only. For a deleted resource, the time after which it will be permamently deleted. It is only populated as a response to a Delete request.","format":"google-datetime","readOnly":true,"type":"string"},"failedCount":{"description":"Output only. The number of tasks which reached phase Failed.","format":"int32","readOnly":true,"type":"integer"},"generation":{"description":"Output only. A number that monotonically increases every time the user modifies the desired state.","format":"int64","readOnly":true,"type":"string"},"job":{"description":"Output only. The name of the parent Job.","readOnly":true,"type":"string"},"labels":{"additionalProperties":{"type":"string"},"description":"Output only. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels","readOnly":true,"type":"object"},"launchStage":{"description":"The least stable launch stage needed to create this resource, as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. Note that this value might not be what was used as input. For example, if ALPHA was provided as input in the parent resource, but only BETA and GA-level features are were, this field will be BETA.","enum":["LAUNCH_STAGE_UNSPECIFIED","UNIMPLEMENTED","PRELAUNCH","EARLY_ACCESS","ALPHA","BETA","GA","DEPRECATED"],"type":"string"},"logUri":{"description":"Output only. URI where logs for this execution can be found in Cloud Console.","readOnly":true,"type":"string"},"name":{"description":"Output only. The unique name of this Execution.","readOnly":true,"type":"string"},"observedGeneration":{"description":"Output only. The generation of this Execution. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.","format":"int64","readOnly":true,"type":"string"},"parallelism":{"description":"Output only. Specifies the maximum desired number of tasks the execution should run at any given time. Must be <= task_count. The actual number of tasks running in steady state will be less than this number when ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when the work left to do is less than max parallelism.","format":"int32","readOnly":true,"type":"integer"},"reconciling":{"description":"Output only. Indicates whether the resource's reconciliation is still in progress. See comments in `Job.reconciling` for additional information on reconciliation process in Cloud Run.","readOnly":true,"type":"boolean"},"retriedCount":{"description":"Output only. The number of tasks which have retried at least once.","format":"int32","readOnly":true,"type":"integer"},"runningCount":{"description":"Output only. The number of actively running tasks.","format":"int32","readOnly":true,"type":"integer"},"satisfiesPzs":{"description":"Output only. Reserved for future use.","readOnly":true,"type":"boolean"},"startTime":{"description":"Output only. Represents time when the execution started to run. It is not guaranteed to be set in happens-before order across separate operations.","format":"google-datetime","readOnly":true,"type":"string"},"succeededCount":{"description":"Output only. The number of tasks which reached phase Succeeded.","format":"int32","readOnly":true,"type":"integer"},"taskCount":{"description":"Output only. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution.","format":"int32","readOnly":true,"type":"integer"},"template":{"$ref":"#/components/schemas/GoogleCloudRunV2TaskTemplate","description":"Output only. The template used to create tasks for this execution.","readOnly":true},"uid":{"description":"Output only. Server assigned unique identifier for the Execution. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.","readOnly":true,"type":"string"},"updateTime":{"description":"Output only. The last-modified time.","format":"google-datetime","readOnly":true,"type":"string"}},"type":"object"},"GoogleCloudRunV2ExecutionReference":{"description":"Reference to an Execution. Use /Executions.GetExecution with the given name to get full execution including the latest status.","properties":{"completionTime":{"description":"Creation timestamp of the execution.","format":"google-datetime","type":"string"},"createTime":{"description":"Creation timestamp of the execution.","format":"google-datetime","type":"string"},"name":{"description":"Name of the execution.","type":"string"}},"type":"object"},"GoogleCloudRunV2ExecutionTemplate":{"description":"ExecutionTemplate describes the data an execution should have when created from a template.","properties":{"annotations":{"additionalProperties":{"type":"string"},"description":"Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system annotations in v1 now have a corresponding field in v2 ExecutionTemplate. This field follows Kubernetes annotations' namespacing, limits, and rules.","type":"object"},"labels":{"additionalProperties":{"type":"string"},"description":"Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 ExecutionTemplate.","type":"object"},"parallelism":{"description":"Specifies the maximum desired number of tasks the execution should run at given time. Must be <= task_count. When the job is run, if this field is 0 or unset, the maximum possible value will be used for that execution. The actual number of tasks running in steady state will be less than this number when there are fewer tasks waiting to be completed remaining, i.e. when the work left to do is less than max parallelism.","format":"int32","type":"integer"},"taskCount":{"description":"Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution. Defaults to 1.","format":"int32","type":"integer"},"template":{"$ref":"#/components/schemas/GoogleCloudRunV2TaskTemplate","description":"Required. Describes the task(s) that will be created when executing an execution."}},"type":"object"},"GoogleCloudRunV2GCSVolumeSource":{"description":"Represents a GCS Bucket mounted as a volume.","properties":{"bucket":{"description":"GCS Bucket name","type":"string"},"readOnly":{"description":"If true, mount the GCS bucket as read-only","type":"boolean"}},"type":"object"},"GoogleCloudRunV2GRPCAction":{"description":"GRPCAction describes an action involving a GRPC port.","properties":{"port":{"description":"Port number of the gRPC service. Number must be in the range 1 to 65535. If not specified, defaults to the exposed port of the container, which is the value of container.ports[0].containerPort.","format":"int32","type":"integer"},"service":{"description":"Service is the name of the service to place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md ). If this is not specified, the default behavior is defined by gRPC.","type":"string"}},"type":"object"},"GoogleCloudRunV2HTTPGetAction":{"description":"HTTPGetAction describes an action based on HTTP Get requests.","properties":{"httpHeaders":{"description":"Custom headers to set in the request. HTTP allows repeated headers.","items":{"$ref":"#/components/schemas/GoogleCloudRunV2HTTPHeader"},"type":"array"},"path":{"description":"Path to access on the HTTP server. Defaults to '/'.","type":"string"},"port":{"description":"Port number to access on the container. Must be in the range 1 to 65535. If not specified, defaults to the exposed port of the container, which is the value of container.ports[0].containerPort.","for