@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Cloud Run Admin API
@base https://run.googleapis.com/
@version v2
@auth OAuth2 | OAuth2
@endpoints 16
@toc {name}(4), {name}:run(1), {name}:wait(1), {parent}(7), {resource}:getIamPolicy(1), {resource}:setIamPolicy(1), {resource}:testIamPermissions(1)

@group {name}
@endpoint DELETE /v2/{name}
@desc Deletes a Revision.
@required {name: str # Required. The name of the Revision to delete. Format: projects/{project}/locations/{location}/services/{service}/revisions/{revision}}
@optional {etag: str # A system-generated fingerprint for this version of the resource. This may be used to detect modification conflict during updates., validateOnly: bool # Indicates that the request should be validated without actually deleting any resources.}
@returns(200) {done: bool, error: map{code: int(int32), details: [map], message: str}, metadata: map, name: str, response: map} # Successful response

@endpoint GET /v2/{name}
@desc Gets information about a Revision.
@required {name: str # Required. The full name of the Revision. Format: projects/{project}/locations/{location}/services/{service}/revisions/{revision}}
@returns(200) {annotations: map, conditions: [map], containers: [map], createTime: str(google-datetime), deleteTime: str(google-datetime), encryptionKey: str, encryptionKeyRevocationAction: str, encryptionKeyShutdownDuration: str(google-duration), etag: str, executionEnvironment: str, expireTime: str(google-datetime), generation: str(int64), labels: map, launchStage: str, logUri: str, maxInstanceRequestConcurrency: int(int32), name: str, observedGeneration: str(int64), reconciling: bool, satisfiesPzs: bool, scaling: map{maxInstanceCount: int(int32), minInstanceCount: int(int32)}, service: str, serviceAccount: str, timeout: str(google-duration), uid: str, updateTime: str(google-datetime), volumes: [map], vpcAccess: map{connector: str, egress: str}} # Successful response

@endpoint PATCH /v2/{name}
@desc Updates a Service.
@required {name: str # 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}}
@optional {allowMissing: bool # This field is currently not used by Cloud Run; setting it does not have any effect., validateOnly: bool # Indicates that the request should be validated and default values populated, without persisting the request or updating any resources., annotations: map # 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 in new resources. All system annotations in v1 now have a corresponding field in v2 Service. This field follows Kubernetes annotations' namespacing, limits, and rules., binaryAuthorization: map{breakglassJustification: str, useDefault: bool} # Settings for Binary Authorization feature., client: str # Arbitrary identifier for the API client., clientVersion: str # Arbitrary version identifier for the API client., conditions: [map{executionReason: str, lastTransitionTime: str(google-datetime), message: str, reason: str, revisionReason: str, severity: str, state: str, type: str}] # Output only. The Conditions of all other associated sub-resources. They contain additional diagnostics information in case the Service does not reach its Serving state. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., createTime: str(google-datetime) # Output only. The creation time., creator: str # Output only. Email address of the authenticated creator., deleteTime: str(google-datetime) # Output only. The deletion time., description: str # User-provided description of the Service. This field currently has a 512-character limit., etag: str # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates., expireTime: str(google-datetime) # Output only. For a deleted resource, the time after which it will be permamently deleted., generation: str(int64) # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`., ingress: str(INGRESS_TRAFFIC_UNSPECIFIED/INGRESS_TRAFFIC_ALL/INGRESS_TRAFFIC_INTERNAL_ONLY/INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER) # Provides the ingress settings for this Service. On output, returns the currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no revision is active., labels: map # Map of string keys and values 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 Service., lastModifier: str # Output only. Email address of the last authenticated modifier., latestCreatedRevision: str # Output only. Name of the last created revision. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., latestReadyRevision: str # Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., launchStage: str(LAUNCH_STAGE_UNSPECIFIED/UNIMPLEMENTED/PRELAUNCH/EARLY_ACCESS/ALPHA/BETA/GA/DEPRECATED) # The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output., name: str # 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}, observedGeneration: str(int64) # Output only. The generation of this Service currently serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`., reconciling: bool # Output only. Returns true if the Service is currently being acted upon by the system to bring it into the desired state. When a new Service is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the Service to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the Service, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created Services. Additional information on the failure can be found in `terminal_condition` and `conditions`., satisfiesPzs: bool # Output only. Reserved for future use., template: map{annotations: map, containers: [map], encryptionKey: str, executionEnvironment: str, labels: map, maxInstanceRequestConcurrency: int(int32), revision: str, scaling: map, serviceAccount: str, timeout: str(google-duration), volumes: [map], vpcAccess: map} # RevisionTemplate describes the data a revision should have when created from a template., terminalCondition: map{executionReason: str, lastTransitionTime: str(google-datetime), message: str, reason: str, revisionReason: str, severity: str, state: str, type: str} # Defines a status condition for a resource., traffic: [map{percent: int(int32), revision: str, tag: str, type: str}] # Specifies how to distribute traffic over a collection of Revisions belonging to the Service. If traffic is empty or not provided, defaults to 100% traffic to the latest `Ready` Revision., trafficStatuses: [map{percent: int(int32), revision: str, tag: str, type: str, uri: str}] # Output only. Detailed status information for corresponding traffic targets. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., uid: str # Output only. Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted., updateTime: str(google-datetime) # Output only. The last-modified time., uri: str # Output only. The main URI in which this Service is serving traffic.}
@returns(200) {done: bool, error: map{code: int(int32), details: [map], message: str}, metadata: map, name: str, response: map} # Successful response

@endpoint GET /v2/{name}/operations
@desc Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.
@required {name: str # Required. To query for all of the operations for a project.}
@optional {filter: str # 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., pageSize: int # 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. ., pageToken: str # Token identifying which result to start with, which is returned by a previous list call.}
@returns(200) {nextPageToken: str, operations: [map]} # Successful response

@endgroup

@group {name}:run
@endpoint POST /v2/{name}:run
@desc Triggers creation of a new Execution of this Job.
@required {name: str # Required. The full name of the Job. Format: projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or number.}
@optional {etag: str # A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates., validateOnly: bool # Indicates that the request should be validated without actually deleting any resources.}
@returns(200) {done: bool, error: map{code: int(int32), details: [map], message: str}, metadata: map, name: str, response: map} # Successful response

@endgroup

@group {name}:wait
@endpoint POST /v2/{name}:wait
@desc 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.
@required {name: str # The name of the operation resource to wait on.}
@optional {timeout: str(google-duration) # The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.}
@returns(200) {done: bool, error: map{code: int(int32), details: [map], message: str}, metadata: map, name: str, response: map} # Successful response

@endgroup

@group {parent}
@endpoint GET /v2/{parent}/executions
@desc Lists Executions from a Job.
@required {parent: str # 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.}
@optional {pageSize: int # Maximum number of Executions to return in this call., pageToken: str # A page token received from a previous call to ListExecutions. All other parameters must match., showDeleted: bool # If true, returns deleted (but unexpired) resources along with active ones.}
@returns(200) {executions: [map], nextPageToken: str} # Successful response

@endpoint GET /v2/{parent}/jobs
@desc Lists Jobs.
@required {parent: str # Required. The location and project to list resources on. Format: projects/{project}/locations/{location}, where {project} can be project id or number.}
@optional {pageSize: int # Maximum number of Jobs to return in this call., pageToken: str # A page token received from a previous call to ListJobs. All other parameters must match., showDeleted: bool # If true, returns deleted (but unexpired) resources along with active ones.}
@returns(200) {jobs: [map], nextPageToken: str} # Successful response

@endpoint POST /v2/{parent}/jobs
@desc Creates a Job.
@required {parent: str # 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.}
@optional {jobId: str # Required. The unique identifier for the Job. The name of the job becomes {parent}/jobs/{job_id}., validateOnly: bool # Indicates that the request should be validated and default values populated, without persisting the request or creating any resources., annotations: map # KRM-style annotations for the resource. 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 on new resources. All system annotations in v1 now have a corresponding field in v2 Job. This field follows Kubernetes annotations' namespacing, limits, and rules., binaryAuthorization: map{breakglassJustification: str, useDefault: bool} # Settings for Binary Authorization feature., client: str # Arbitrary identifier for the API client., clientVersion: str # Arbitrary version identifier for the API client., conditions: [map{executionReason: str, lastTransitionTime: str(google-datetime), message: str, reason: str, revisionReason: str, severity: str, state: str, type: str}] # Output only. The Conditions of all other associated sub-resources. They contain additional diagnostics information in case the Job does not reach its desired state. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., createTime: str(google-datetime) # Output only. The creation time., creator: str # Output only. Email address of the authenticated creator., deleteTime: str(google-datetime) # Output only. The deletion time., etag: str # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates., executionCount: int(int32) # Output only. Number of executions created for this job., expireTime: str(google-datetime) # Output only. For a deleted resource, the time after which it will be permamently deleted., generation: str(int64) # Output only. A number that monotonically increases every time the user modifies the desired state., labels: map # KRM-style labels for the resource. 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 Job., lastModifier: str # Output only. Email address of the last authenticated modifier., latestCreatedExecution: map{completionTime: str(google-datetime), createTime: str(google-datetime), name: str} # Reference to an Execution. Use /Executions.GetExecution with the given name to get full execution including the latest status., launchStage: str(LAUNCH_STAGE_UNSPECIFIED/UNIMPLEMENTED/PRELAUNCH/EARLY_ACCESS/ALPHA/BETA/GA/DEPRECATED) # The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output., name: str # The fully qualified name of this Job. Format: projects/{project}/locations/{location}/jobs/{job}, observedGeneration: str(int64) # Output only. The generation of this Job. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., reconciling: bool # Output only. Returns true if the Job is currently being acted upon by the system to bring it into the desired state. When a new Job is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the Job to the desired state. This process is called reconciliation. While reconciliation is in process, `observed_generation` and `latest_succeeded_execution`, will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the state matches the Job, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `observed_generation` and `generation`, `latest_succeeded_execution` and `latest_created_execution`. If reconciliation failed, `observed_generation` and `latest_succeeded_execution` will have the state of the last succeeded execution or empty for newly created Job. Additional information on the failure can be found in `terminal_condition` and `conditions`., satisfiesPzs: bool # Output only. Reserved for future use., template: map{annotations: map, labels: map, parallelism: int(int32), taskCount: int(int32), template: map} # ExecutionTemplate describes the data an execution should have when created from a template., terminalCondition: map{executionReason: str, lastTransitionTime: str(google-datetime), message: str, reason: str, revisionReason: str, severity: str, state: str, type: str} # Defines a status condition for a resource., uid: str # 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., updateTime: str(google-datetime) # Output only. The last-modified time.}
@returns(200) {done: bool, error: map{code: int(int32), details: [map], message: str}, metadata: map, name: str, response: map} # Successful response

@endpoint GET /v2/{parent}/revisions
@desc Lists Revisions from a given Service, or from a given location.
@required {parent: str # 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}}
@optional {pageSize: int # Maximum number of revisions to return in this call., pageToken: str # A page token received from a previous call to ListRevisions. All other parameters must match., showDeleted: bool # If true, returns deleted (but unexpired) resources along with active ones.}
@returns(200) {nextPageToken: str, revisions: [map]} # Successful response

@endpoint GET /v2/{parent}/services
@desc Lists Services.
@required {parent: str # 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.}
@optional {pageSize: int # Maximum number of Services to return in this call., pageToken: str # A page token received from a previous call to ListServices. All other parameters must match., showDeleted: bool # If true, returns deleted (but unexpired) resources along with active ones.}
@returns(200) {nextPageToken: str, services: [map]} # Successful response

@endpoint POST /v2/{parent}/services
@desc Creates a new Service in a given project and location.
@required {parent: str # 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.}
@optional {serviceId: str # 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}., validateOnly: bool # Indicates that the request should be validated and default values populated, without persisting the request or creating any resources., annotations: map # 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 in new resources. All system annotations in v1 now have a corresponding field in v2 Service. This field follows Kubernetes annotations' namespacing, limits, and rules., binaryAuthorization: map{breakglassJustification: str, useDefault: bool} # Settings for Binary Authorization feature., client: str # Arbitrary identifier for the API client., clientVersion: str # Arbitrary version identifier for the API client., conditions: [map{executionReason: str, lastTransitionTime: str(google-datetime), message: str, reason: str, revisionReason: str, severity: str, state: str, type: str}] # Output only. The Conditions of all other associated sub-resources. They contain additional diagnostics information in case the Service does not reach its Serving state. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., createTime: str(google-datetime) # Output only. The creation time., creator: str # Output only. Email address of the authenticated creator., deleteTime: str(google-datetime) # Output only. The deletion time., description: str # User-provided description of the Service. This field currently has a 512-character limit., etag: str # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates., expireTime: str(google-datetime) # Output only. For a deleted resource, the time after which it will be permamently deleted., generation: str(int64) # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`., ingress: str(INGRESS_TRAFFIC_UNSPECIFIED/INGRESS_TRAFFIC_ALL/INGRESS_TRAFFIC_INTERNAL_ONLY/INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER) # Provides the ingress settings for this Service. On output, returns the currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no revision is active., labels: map # Map of string keys and values 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 Service., lastModifier: str # Output only. Email address of the last authenticated modifier., latestCreatedRevision: str # Output only. Name of the last created revision. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., latestReadyRevision: str # Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., launchStage: str(LAUNCH_STAGE_UNSPECIFIED/UNIMPLEMENTED/PRELAUNCH/EARLY_ACCESS/ALPHA/BETA/GA/DEPRECATED) # The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output., name: str # 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}, observedGeneration: str(int64) # Output only. The generation of this Service currently serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`., reconciling: bool # Output only. Returns true if the Service is currently being acted upon by the system to bring it into the desired state. When a new Service is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the Service to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the Service, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created Services. Additional information on the failure can be found in `terminal_condition` and `conditions`., satisfiesPzs: bool # Output only. Reserved for future use., template: map{annotations: map, containers: [map], encryptionKey: str, executionEnvironment: str, labels: map, maxInstanceRequestConcurrency: int(int32), revision: str, scaling: map, serviceAccount: str, timeout: str(google-duration), volumes: [map], vpcAccess: map} # RevisionTemplate describes the data a revision should have when created from a template., terminalCondition: map{executionReason: str, lastTransitionTime: str(google-datetime), message: str, reason: str, revisionReason: str, severity: str, state: str, type: str} # Defines a status condition for a resource., traffic: [map{percent: int(int32), revision: str, tag: str, type: str}] # Specifies how to distribute traffic over a collection of Revisions belonging to the Service. If traffic is empty or not provided, defaults to 100% traffic to the latest `Ready` Revision., trafficStatuses: [map{percent: int(int32), revision: str, tag: str, type: str, uri: str}] # Output only. Detailed status information for corresponding traffic targets. See comments in `reconciling` for additional information on reconciliation process in Cloud Run., uid: str # Output only. Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted., updateTime: str(google-datetime) # Output only. The last-modified time., uri: str # Output only. The main URI in which this Service is serving traffic.}
@returns(200) {done: bool, error: map{code: int(int32), details: [map], message: str}, metadata: map, name: str, response: map} # Successful response

@endpoint GET /v2/{parent}/tasks
@desc Lists Tasks from an Execution of a Job.
@required {parent: str # 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}}
@optional {pageSize: int # Maximum number of Tasks to return in this call., pageToken: str # A page token received from a previous call to ListTasks. All other parameters must match., showDeleted: bool # If true, returns deleted (but unexpired) resources along with active ones.}
@returns(200) {nextPageToken: str, tasks: [map]} # Successful response

@endgroup

@group {resource}:getIamPolicy
@endpoint GET /v2/{resource}:getIamPolicy
@desc Gets the IAM Access Control policy currently in effect for the given Cloud Run Service. This result does not include any inherited policies.
@required {resource: str # 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.}
@optional {options.requestedPolicyVersion: int # 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).}
@returns(200) {auditConfigs: [map], bindings: [map], etag: str(byte), version: int(int32)} # Successful response

@endgroup

@group {resource}:setIamPolicy
@endpoint POST /v2/{resource}:setIamPolicy
@desc Sets the IAM Access control policy for the specified Service. Overwrites any existing policy.
@required {resource: str # 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.}
@optional {policy: map{auditConfigs: [map], bindings: [map], etag: str(byte), version: int(int32)} # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/)., updateMask: str(google-fieldmask) # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: "bindings, etag"`}
@returns(200) {auditConfigs: [map], bindings: [map], etag: str(byte), version: int(int32)} # Successful response

@endgroup

@group {resource}:testIamPermissions
@endpoint POST /v2/{resource}:testIamPermissions
@desc Returns permissions that a caller has on the specified Project. There are no permissions required for making this API call.
@required {resource: str # 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.}
@optional {permissions: [str] # The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).}
@returns(200) {permissions: [str]} # Successful response

@endgroup

@end