diff --git a/discovery/run-v1.json b/discovery/run-v1.json index 4b38f83514..12811a4afb 100644 --- a/discovery/run-v1.json +++ b/discovery/run-v1.json @@ -2614,7 +2614,7 @@ } } }, - "revision": "20240927", + "revision": "20250117", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -3514,6 +3514,13 @@ "description": "Artifacts produced by a build that should be uploaded upon successful completion of all build steps.", "id": "GoogleDevtoolsCloudbuildV1Artifacts", "properties": { + "goModules": { + "description": "Optional. A list of Go modules to be uploaded to Artifact Registry upon successful completion of all build steps. If any objects fail to be pushed, the build is marked FAILURE.", + "items": { + "$ref": "GoogleDevtoolsCloudbuildV1GoModule" + }, + "type": "array" + }, "images": { "description": "A list of images to be pushed upon the successful completion of all build steps. The images will be pushed using the builder service account's credentials. The digests of the pushed images will be stored in the Build resource's results field. If any of the images fail to be pushed, the build is marked FAILURE.", "items": { @@ -3820,6 +3827,10 @@ "description": "Option to specify whether or not to apply bash style string operations to the substitutions. NOTE: this is always enabled for triggered builds and cannot be overridden in the build configuration file.", "type": "boolean" }, + "enableStructuredLogging": { + "description": "Optional. Option to specify whether structured logging is enabled. If true, JSON-formatted logs are parsed as structured logs.", + "type": "boolean" + }, "env": { "description": "A list of global environment variable definitions that will exist for all build steps in this build. If a variable is defined in both globally and in a build step, the variable will use the build step value. The elements are of the form \"KEY=VALUE\" for the environment variable \"KEY\" being given the value \"VALUE\".", "items": { @@ -3927,12 +3938,14 @@ "NONE", "SHA256", "MD5", + "GO_MODULE_H1", "SHA512" ], "enumDescriptions": [ "No hash requested.", "Use a sha256 hash.", "Use a md5 hash.", + "Dirhash of a Go module's source code which is then hex-encoded.", "Use a sha512 hash." ], "type": "string" @@ -4229,6 +4242,37 @@ }, "type": "object" }, + "GoogleDevtoolsCloudbuildV1GoModule": { + "description": "Go module to upload to Artifact Registry upon successful completion of all build steps. A module refers to all dependencies in a go.mod file.", + "id": "GoogleDevtoolsCloudbuildV1GoModule", + "properties": { + "modulePath": { + "description": "Optional. The Go module's \"module path\". e.g. example.com/foo/v2", + "type": "string" + }, + "moduleVersion": { + "description": "Optional. The Go module's semantic version in the form vX.Y.Z. e.g. v0.1.1 Pre-release identifiers can also be added by appending a dash and dot separated ASCII alphanumeric characters and hyphens. e.g. v0.2.3-alpha.x.12m.5", + "type": "string" + }, + "repositoryLocation": { + "description": "Optional. Location of the Artifact Registry repository. i.e. us-east1 Defaults to the build’s location.", + "type": "string" + }, + "repositoryName": { + "description": "Optional. Artifact Registry repository name. Specified Go modules will be zipped and uploaded to Artifact Registry with this location as a prefix. e.g. my-go-repo", + "type": "string" + }, + "repositoryProjectId": { + "description": "Optional. Project ID of the Artifact Registry repository. Defaults to the build project.", + "type": "string" + }, + "sourcePath": { + "description": "Optional. Source path of the go.mod file in the build's workspace. If not specified, this will default to the current directory. e.g. ~/code/go/mypackage", + "type": "string" + } + }, + "type": "object" + }, "GoogleDevtoolsCloudbuildV1Hash": { "description": "Container message for hash values.", "id": "GoogleDevtoolsCloudbuildV1Hash", @@ -4239,12 +4283,14 @@ "NONE", "SHA256", "MD5", + "GO_MODULE_H1", "SHA512" ], "enumDescriptions": [ "No hash requested.", "Use a sha256 hash.", "Use a md5 hash.", + "Dirhash of a Go module's source code which is then hex-encoded.", "Use a sha512 hash." ], "type": "string" @@ -4427,6 +4473,13 @@ }, "type": "array" }, + "goModules": { + "description": "Optional. Go module artifacts uploaded to Artifact Registry at the end of the build.", + "items": { + "$ref": "GoogleDevtoolsCloudbuildV1UploadedGoModule" + }, + "type": "array" + }, "images": { "description": "Container images that were built as a part of the build.", "items": { @@ -4657,6 +4710,26 @@ }, "type": "object" }, + "GoogleDevtoolsCloudbuildV1UploadedGoModule": { + "description": "A Go module artifact uploaded to Artifact Registry using the GoModule directive.", + "id": "GoogleDevtoolsCloudbuildV1UploadedGoModule", + "properties": { + "fileHashes": { + "$ref": "GoogleDevtoolsCloudbuildV1FileHashes", + "description": "Hash types and values of the Go Module Artifact." + }, + "pushTiming": { + "$ref": "GoogleDevtoolsCloudbuildV1TimeSpan", + "description": "Output only. Stores timing information for pushing the specified artifact.", + "readOnly": true + }, + "uri": { + "description": "URI of the uploaded artifact.", + "type": "string" + } + }, + "type": "object" + }, "GoogleDevtoolsCloudbuildV1UploadedMavenArtifact": { "description": "A Maven artifact uploaded using the MavenArtifact directive.", "id": "GoogleDevtoolsCloudbuildV1UploadedMavenArtifact", @@ -5383,7 +5456,7 @@ "additionalProperties": { "type": "string" }, - "description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service. * `run.googleapis.com/build-id`: Service. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision . * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution.", + "description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service. * `run.googleapis.com/build-id`: Service. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision . * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution.", "type": "object" }, "clusterName": { @@ -5770,7 +5843,7 @@ "properties": { "metadata": { "$ref": "ObjectMeta", - "description": "Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`." + "description": "Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`." }, "spec": { "$ref": "RevisionSpec", diff --git a/discovery/run-v2.json b/discovery/run-v2.json index 7c80c2bd79..a51a03e012 100644 --- a/discovery/run-v2.json +++ b/discovery/run-v2.json @@ -428,7 +428,7 @@ ], "parameters": { "parent": { - "description": "Required. The project and location to build in. Location must be a region, e.g., 'us-central1' or 'global' if the global builder is to be used. Format: projects/{project}/locations/{location}", + "description": "Required. The project and location to build in. Location must be a region, e.g., 'us-central1' or 'global' if the global builder is to be used. Format: `projects/{project}/locations/{location}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1520,13 +1520,122 @@ } } } + }, + "workerPools": { + "resources": { + "revisions": { + "methods": { + "delete": { + "description": "Deletes a Revision.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/workerPools/{workerPoolsId}/revisions/{revisionsId}", + "httpMethod": "DELETE", + "id": "run.projects.locations.workerPools.revisions.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "A system-generated fingerprint for this version of the resource. This may be used to detect modification conflict during updates.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the Revision to delete. Format: projects/{project}/locations/{location}/services/{service}/revisions/{revision}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/workerPools/[^/]+/revisions/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Indicates that the request should be validated without actually deleting any resources.", + "location": "query", + "type": "boolean" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets information about a Revision.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/workerPools/{workerPoolsId}/revisions/{revisionsId}", + "httpMethod": "GET", + "id": "run.projects.locations.workerPools.revisions.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The full name of the Revision. Format: projects/{project}/locations/{location}/services/{service}/revisions/{revision}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/workerPools/[^/]+/revisions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GoogleCloudRunV2Revision" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists Revisions from a given Service, or from a given location. Results are sorted by creation time, descending.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/workerPools/{workerPoolsId}/revisions", + "httpMethod": "GET", + "id": "run.projects.locations.workerPools.revisions.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of revisions to return in this call.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from a previous call to ListRevisions. All other parameters must match.", + "location": "query", + "type": "string" + }, + "parent": { + "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}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/workerPools/[^/]+$", + "required": true, + "type": "string" + }, + "showDeleted": { + "description": "If true, returns deleted (but unexpired) resources along with active ones.", + "location": "query", + "type": "boolean" + } + }, + "path": "v2/{+parent}/revisions", + "response": { + "$ref": "GoogleCloudRunV2ListRevisionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } } } } } } }, - "revision": "20240927", + "revision": "20250117", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -1538,7 +1647,7 @@ "type": "string" }, "policy": { - "description": "Optional. The path to a binary authorization policy. Format: projects/{project}/platforms/cloudRun/{policy-name}", + "description": "Optional. The path to a binary authorization policy. Format: `projects/{project}/platforms/cloudRun/{policy-name}`", "type": "string" }, "useDefault": { @@ -1548,12 +1657,76 @@ }, "type": "object" }, + "GoogleCloudRunV2BuildConfig": { + "description": "Describes the Build step of the function that builds a container from the given source.", + "id": "GoogleCloudRunV2BuildConfig", + "properties": { + "baseImage": { + "description": "Optional. The base image used to build the function.", + "type": "string" + }, + "enableAutomaticUpdates": { + "description": "Optional. Sets whether the function will receive automatic base image updates.", + "type": "boolean" + }, + "environmentVariables": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. User-provided build-time environment variables for the function", + "type": "object" + }, + "functionTarget": { + "description": "Optional. The name of the function (as defined in source code) that will be executed. Defaults to the resource name suffix, if not specified. For backward compatibility, if function with given name is not found, then the system will try to use function named \"function\".", + "type": "string" + }, + "imageUri": { + "description": "Optional. Artifact Registry URI to store the built image.", + "type": "string" + }, + "name": { + "description": "Output only. The Cloud Build name of the latest successful deployment of the function.", + "readOnly": true, + "type": "string" + }, + "serviceAccount": { + "description": "Optional. Service account to be used for building the container. The format of this field is `projects/{projectId}/serviceAccounts/{serviceAccountEmail}`.", + "type": "string" + }, + "sourceLocation": { + "description": "The Cloud Storage bucket URI where the function source code is located.", + "type": "string" + }, + "workerPool": { + "description": "Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the Cloud Run function. The format of this field is `projects/{project}/locations/{region}/workerPools/{workerPool}` where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRunV2BuildInfo": { + "description": "Build information of the image.", + "id": "GoogleCloudRunV2BuildInfo", + "properties": { + "functionTarget": { + "description": "Output only. Entry point of the function when the image is a Cloud Run function.", + "readOnly": true, + "type": "string" + }, + "sourceLocation": { + "description": "Output only. Source code location of the image.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRunV2BuildpacksBuild": { "description": "Build the source using Buildpacks.", "id": "GoogleCloudRunV2BuildpacksBuild", "properties": { "baseImage": { - "description": "Optional. The base image used to opt into automatic base image updates.", + "description": "Optional. The base image to use for the build.", "type": "string" }, "cacheImageUri": { @@ -1575,6 +1748,10 @@ "description": "Optional. Name of the function target if the source is a function source. Required for function builds.", "type": "string" }, + "projectDescriptor": { + "description": "Optional. project_descriptor stores the path to the project descriptor file. When empty, it means that there is no project descriptor file in the source.", + "type": "string" + }, "runtime": { "deprecated": true, "description": "The runtime name, e.g. 'go113'. Leave blank for generic builds.", @@ -1772,6 +1949,15 @@ }, "type": "array" }, + "baseImageUri": { + "description": "Base image for this container. Only supported for services. If set. it indicates that the service is enrolled into automatic base image update.", + "type": "string" + }, + "buildInfo": { + "$ref": "GoogleCloudRunV2BuildInfo", + "description": "Output only. The build info of the container image.", + "readOnly": true + }, "command": { "description": "Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.", "items": { @@ -1976,6 +2162,11 @@ "readOnly": true, "type": "string" }, + "creator": { + "description": "Output only. Email address of the authenticated creator.", + "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", @@ -2267,6 +2458,13 @@ "description": "Cloud Storage Bucket name.", "type": "string" }, + "mountOptions": { + "description": "A list of additional flags to pass to the gcsfuse CLI. Options should be specified without the leading \"--\".", + "items": { + "type": "string" + }, + "type": "array" + }, "readOnly": { "description": "If true, the volume will be mounted as read only for all mounts.", "type": "boolean" @@ -3030,6 +3228,25 @@ "description": "A reference to a customer managed encryption key (CMEK) to use to encrypt this container image. For more information, go to https://cloud.google.com/run/docs/securing/using-cmek", "type": "string" }, + "encryptionKeyRevocationAction": { + "description": "Optional. The action to take if the encryption key is revoked.", + "enum": [ + "ENCRYPTION_KEY_REVOCATION_ACTION_UNSPECIFIED", + "PREVENT_NEW", + "SHUTDOWN" + ], + "enumDescriptions": [ + "Unspecified", + "Prevents the creation of new instances.", + "Shuts down existing instances, and prevents creation of new ones." + ], + "type": "string" + }, + "encryptionKeyShutdownDuration": { + "description": "Optional. If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.", + "format": "google-duration", + "type": "string" + }, "executionEnvironment": { "description": "Optional. The sandbox environment to host this Revision.", "enum": [ @@ -3056,7 +3273,7 @@ "type": "object" }, "maxInstanceRequestConcurrency": { - "description": "Optional. Sets the maximum number of requests that each serving instance can receive. If not specified or 0, defaults to 80 when requested CPU >= 1 and defaults to 1 when requested CPU < 1.", + "description": "Optional. Sets the maximum number of requests that each serving instance can receive. If not specified or 0, concurrency defaults to 80 when requested `CPU >= 1` and defaults to 1 when requested `CPU < 1`.", "format": "int32", "type": "integer" }, @@ -3142,7 +3359,7 @@ "id": "GoogleCloudRunV2SecretVolumeSource", "properties": { "defaultMode": { - "description": "Integer representation of mode bits to use on created files by default. Must be a value between 0000 and 0777 (octal), defaulting to 0444. Directories within the path are not affected by this setting. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 777 (a=rwx), set to 0777 (octal) or 511 (base-10). For chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set. This might be in conflict with other options that affect the file mode, like fsGroup, and as a result, other mode bits could be set.", + "description": "Integer representation of mode bits to use on created files by default. Must be a value between 0000 and 0777 (octal), defaulting to 0444. Directories within the path are not affected by this setting. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set. This might be in conflict with other options that affect the file mode, like fsGroup, and as a result, other mode bits could be set.", "format": "int32", "type": "integer" }, @@ -3175,6 +3392,10 @@ "$ref": "GoogleCloudRunV2BinaryAuthorization", "description": "Optional. Settings for the Binary Authorization feature." }, + "buildConfig": { + "$ref": "GoogleCloudRunV2BuildConfig", + "description": "Optional. Configuration for building a Cloud Run function." + }, "client": { "description": "Arbitrary identifier for the API client.", "type": "string" @@ -3259,7 +3480,7 @@ "type": "string" }, "invokerIamDisabled": { - "description": "Optional. Disables IAM permission check for run.routes.invoke for callers of this service. This setting should not be used with external ingress.", + "description": "Optional. Disables IAM permission check for run.routes.invoke for callers of this service. This feature is available by invitation only. For more information, visit https://cloud.google.com/run/docs/securing/managing-access#invoker_check.", "type": "boolean" }, "labels": { @@ -3388,7 +3609,7 @@ "id": "GoogleCloudRunV2ServiceMesh", "properties": { "mesh": { - "description": "The Mesh resource name. Format: projects/{project}/locations/global/meshes/{mesh}, where {project} can be project id or number.", + "description": "The Mesh resource name. Format: `projects/{project}/locations/global/meshes/{mesh}`, where `{project}` can be project id or number.", "type": "string" } }, @@ -3398,6 +3619,16 @@ "description": "Scaling settings applied at the service level rather than at the revision level.", "id": "GoogleCloudRunV2ServiceScaling", "properties": { + "manualInstanceCount": { + "description": "Optional. total instance count for the service in manual scaling mode. This number of instances is divided among all revisions with specified traffic based on the percent of traffic they are receiving.", + "format": "int32", + "type": "integer" + }, + "maxInstanceCount": { + "description": "Optional. total max instances for the service. This number of instances is divided among all revisions with specified traffic based on the percent of traffic they are receiving.", + "format": "int32", + "type": "integer" + }, "minInstanceCount": { "description": "Optional. total min instances for the service. This number of instances is divided among all revisions with specified traffic based on the percent of traffic they are receiving.", "format": "int32", @@ -3472,7 +3703,7 @@ "type": "array" }, "workerPool": { - "description": "Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project}/locations/{region}/workerPools/{workerPool}` where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool.", + "description": "Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project}/locations/{region}/workerPools/{workerPool}` where `{project}` and `{region}` are the project id and region respectively where the worker pool is defined and `{workerPool}` is the short name of the worker pool.", "type": "string" } }, @@ -3855,7 +4086,7 @@ "id": "GoogleCloudRunV2VersionToPath", "properties": { "mode": { - "description": "Integer octal mode bits to use on this file, must be a value between 01 and 0777 (octal). If 0 or not set, the Volume's default mode will be used. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 777 (a=rwx), set to 0777 (octal) or 511 (base-10). For chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.", + "description": "Integer octal mode bits to use on this file, must be a value between 01 and 0777 (octal). If 0 or not set, the Volume's default mode will be used. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.", "format": "int32", "type": "integer" }, @@ -3921,7 +4152,7 @@ "id": "GoogleCloudRunV2VpcAccess", "properties": { "connector": { - "description": "VPC Access connector name. Format: projects/{project}/locations/{location}/connectors/{connector}, where {project} can be project id or number. For more information on sending traffic to a VPC network via a connector, visit https://cloud.google.com/run/docs/configuring/vpc-connectors.", + "description": "VPC Access connector name. Format: `projects/{project}/locations/{location}/connectors/{connector}`, where `{project}` can be project id or number. For more information on sending traffic to a VPC network via a connector, visit https://cloud.google.com/run/docs/configuring/vpc-connectors.", "type": "string" }, "egress": { @@ -4026,6 +4257,13 @@ "description": "Artifacts produced by a build that should be uploaded upon successful completion of all build steps.", "id": "GoogleDevtoolsCloudbuildV1Artifacts", "properties": { + "goModules": { + "description": "Optional. A list of Go modules to be uploaded to Artifact Registry upon successful completion of all build steps. If any objects fail to be pushed, the build is marked FAILURE.", + "items": { + "$ref": "GoogleDevtoolsCloudbuildV1GoModule" + }, + "type": "array" + }, "images": { "description": "A list of images to be pushed upon the successful completion of all build steps. The images will be pushed using the builder service account's credentials. The digests of the pushed images will be stored in the Build resource's results field. If any of the images fail to be pushed, the build is marked FAILURE.", "items": { @@ -4332,6 +4570,10 @@ "description": "Option to specify whether or not to apply bash style string operations to the substitutions. NOTE: this is always enabled for triggered builds and cannot be overridden in the build configuration file.", "type": "boolean" }, + "enableStructuredLogging": { + "description": "Optional. Option to specify whether structured logging is enabled. If true, JSON-formatted logs are parsed as structured logs.", + "type": "boolean" + }, "env": { "description": "A list of global environment variable definitions that will exist for all build steps in this build. If a variable is defined in both globally and in a build step, the variable will use the build step value. The elements are of the form \"KEY=VALUE\" for the environment variable \"KEY\" being given the value \"VALUE\".", "items": { @@ -4439,12 +4681,14 @@ "NONE", "SHA256", "MD5", + "GO_MODULE_H1", "SHA512" ], "enumDescriptions": [ "No hash requested.", "Use a sha256 hash.", "Use a md5 hash.", + "Dirhash of a Go module's source code which is then hex-encoded.", "Use a sha512 hash." ], "type": "string" @@ -4741,6 +4985,37 @@ }, "type": "object" }, + "GoogleDevtoolsCloudbuildV1GoModule": { + "description": "Go module to upload to Artifact Registry upon successful completion of all build steps. A module refers to all dependencies in a go.mod file.", + "id": "GoogleDevtoolsCloudbuildV1GoModule", + "properties": { + "modulePath": { + "description": "Optional. The Go module's \"module path\". e.g. example.com/foo/v2", + "type": "string" + }, + "moduleVersion": { + "description": "Optional. The Go module's semantic version in the form vX.Y.Z. e.g. v0.1.1 Pre-release identifiers can also be added by appending a dash and dot separated ASCII alphanumeric characters and hyphens. e.g. v0.2.3-alpha.x.12m.5", + "type": "string" + }, + "repositoryLocation": { + "description": "Optional. Location of the Artifact Registry repository. i.e. us-east1 Defaults to the build’s location.", + "type": "string" + }, + "repositoryName": { + "description": "Optional. Artifact Registry repository name. Specified Go modules will be zipped and uploaded to Artifact Registry with this location as a prefix. e.g. my-go-repo", + "type": "string" + }, + "repositoryProjectId": { + "description": "Optional. Project ID of the Artifact Registry repository. Defaults to the build project.", + "type": "string" + }, + "sourcePath": { + "description": "Optional. Source path of the go.mod file in the build's workspace. If not specified, this will default to the current directory. e.g. ~/code/go/mypackage", + "type": "string" + } + }, + "type": "object" + }, "GoogleDevtoolsCloudbuildV1Hash": { "description": "Container message for hash values.", "id": "GoogleDevtoolsCloudbuildV1Hash", @@ -4751,12 +5026,14 @@ "NONE", "SHA256", "MD5", + "GO_MODULE_H1", "SHA512" ], "enumDescriptions": [ "No hash requested.", "Use a sha256 hash.", "Use a md5 hash.", + "Dirhash of a Go module's source code which is then hex-encoded.", "Use a sha512 hash." ], "type": "string" @@ -4939,6 +5216,13 @@ }, "type": "array" }, + "goModules": { + "description": "Optional. Go module artifacts uploaded to Artifact Registry at the end of the build.", + "items": { + "$ref": "GoogleDevtoolsCloudbuildV1UploadedGoModule" + }, + "type": "array" + }, "images": { "description": "Container images that were built as a part of the build.", "items": { @@ -5169,6 +5453,26 @@ }, "type": "object" }, + "GoogleDevtoolsCloudbuildV1UploadedGoModule": { + "description": "A Go module artifact uploaded to Artifact Registry using the GoModule directive.", + "id": "GoogleDevtoolsCloudbuildV1UploadedGoModule", + "properties": { + "fileHashes": { + "$ref": "GoogleDevtoolsCloudbuildV1FileHashes", + "description": "Hash types and values of the Go Module Artifact." + }, + "pushTiming": { + "$ref": "GoogleDevtoolsCloudbuildV1TimeSpan", + "description": "Output only. Stores timing information for pushing the specified artifact.", + "readOnly": true + }, + "uri": { + "description": "URI of the uploaded artifact.", + "type": "string" + } + }, + "type": "object" + }, "GoogleDevtoolsCloudbuildV1UploadedMavenArtifact": { "description": "A Maven artifact uploaded using the MavenArtifact directive.", "id": "GoogleDevtoolsCloudbuildV1UploadedMavenArtifact", @@ -5548,25 +5852,25 @@ "id": "UtilStatusProto", "properties": { "canonicalCode": { - "description": "The canonical error code (see codes.proto) that most closely corresponds to this status. This may be missing, and in the common case of the generic space, it definitely will be.", + "description": "The canonical error code (see codes.proto) that most closely corresponds to this status. This may be missing, and in the common case of the generic space, it definitely will be. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional int32 canonical_code = 6;", "format": "int32", "type": "integer" }, "code": { - "description": "Numeric code drawn from the space specified below. Often, this is the canonical error space, and code is drawn from google3/util/task/codes.proto", + "description": "Numeric code drawn from the space specified below. Often, this is the canonical error space, and code is drawn from google3/util/task/codes.proto copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional int32 code = 1;", "format": "int32", "type": "integer" }, "message": { - "description": "Detail message", + "description": "Detail message copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional string message = 3;", "type": "string" }, "messageSet": { "$ref": "Proto2BridgeMessageSet", - "description": "message_set associates an arbitrary proto message with the status." + "description": "message_set associates an arbitrary proto message with the status. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional proto2.bridge.MessageSet message_set = 5;" }, "space": { - "description": "The following are usually only present when code != 0 Space to which this status belongs", + "description": "The following are usually only present when code != 0 Space to which this status belongs copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional string space = 2;", "type": "string" } }, diff --git a/src/apis/run/v1.ts b/src/apis/run/v1.ts index be81ae4407..764ae5b047 100644 --- a/src/apis/run/v1.ts +++ b/src/apis/run/v1.ts @@ -804,6 +804,10 @@ export namespace run_v1 { * Artifacts produced by a build that should be uploaded upon successful completion of all build steps. */ export interface Schema$GoogleDevtoolsCloudbuildV1Artifacts { + /** + * Optional. A list of Go modules to be uploaded to Artifact Registry upon successful completion of all build steps. If any objects fail to be pushed, the build is marked FAILURE. + */ + goModules?: Schema$GoogleDevtoolsCloudbuildV1GoModule[]; /** * A list of images to be pushed upon the successful completion of all build steps. The images will be pushed using the builder service account's credentials. The digests of the pushed images will be stored in the Build resource's results field. If any of the images fail to be pushed, the build is marked FAILURE. */ @@ -996,6 +1000,10 @@ export namespace run_v1 { * Option to specify whether or not to apply bash style string operations to the substitutions. NOTE: this is always enabled for triggered builds and cannot be overridden in the build configuration file. */ dynamicSubstitutions?: boolean | null; + /** + * Optional. Option to specify whether structured logging is enabled. If true, JSON-formatted logs are parsed as structured logs. + */ + enableStructuredLogging?: boolean | null; /** * A list of global environment variable definitions that will exist for all build steps in this build. If a variable is defined in both globally and in a build step, the variable will use the build step value. The elements are of the form "KEY=VALUE" for the environment variable "KEY" being given the value "VALUE". */ @@ -1217,6 +1225,35 @@ export namespace run_v1 { */ url?: string | null; } + /** + * Go module to upload to Artifact Registry upon successful completion of all build steps. A module refers to all dependencies in a go.mod file. + */ + export interface Schema$GoogleDevtoolsCloudbuildV1GoModule { + /** + * Optional. The Go module's "module path". e.g. example.com/foo/v2 + */ + modulePath?: string | null; + /** + * Optional. The Go module's semantic version in the form vX.Y.Z. e.g. v0.1.1 Pre-release identifiers can also be added by appending a dash and dot separated ASCII alphanumeric characters and hyphens. e.g. v0.2.3-alpha.x.12m.5 + */ + moduleVersion?: string | null; + /** + * Optional. Location of the Artifact Registry repository. i.e. us-east1 Defaults to the build’s location. + */ + repositoryLocation?: string | null; + /** + * Optional. Artifact Registry repository name. Specified Go modules will be zipped and uploaded to Artifact Registry with this location as a prefix. e.g. my-go-repo + */ + repositoryName?: string | null; + /** + * Optional. Project ID of the Artifact Registry repository. Defaults to the build project. + */ + repositoryProjectId?: string | null; + /** + * Optional. Source path of the go.mod file in the build's workspace. If not specified, this will default to the current directory. e.g. ~/code/go/mypackage + */ + sourcePath?: string | null; + } /** * Container message for hash values. */ @@ -1369,6 +1406,10 @@ export namespace run_v1 { * List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted. */ buildStepOutputs?: string[] | null; + /** + * Optional. Go module artifacts uploaded to Artifact Registry at the end of the build. + */ + goModules?: Schema$GoogleDevtoolsCloudbuildV1UploadedGoModule[]; /** * Container images that were built as a part of the build. */ @@ -1540,6 +1581,23 @@ export namespace run_v1 { */ startTime?: string | null; } + /** + * A Go module artifact uploaded to Artifact Registry using the GoModule directive. + */ + export interface Schema$GoogleDevtoolsCloudbuildV1UploadedGoModule { + /** + * Hash types and values of the Go Module Artifact. + */ + fileHashes?: Schema$GoogleDevtoolsCloudbuildV1FileHashes; + /** + * Output only. Stores timing information for pushing the specified artifact. + */ + pushTiming?: Schema$GoogleDevtoolsCloudbuildV1TimeSpan; + /** + * URI of the uploaded artifact. + */ + uri?: string | null; + } /** * A Maven artifact uploaded using the MavenArtifact directive. */ @@ -2111,7 +2169,7 @@ export namespace run_v1 { */ export interface Schema$ObjectMeta { /** - * Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service. * `run.googleapis.com/build-id`: Service. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision . * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution. + * Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Service, Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-base-image`: Service. * `run.googleapis.com/build-enable-automatic-updates`: Service. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-function-target`: Service. * `run.googleapis.com/build-id`: Service. * `run.googleapis.com/build-image-uri`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-source-location`: Service. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision . * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/health-check-disabled`: Revision. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution. */ annotations?: {[key: string]: string} | null; /** @@ -2406,7 +2464,7 @@ export namespace run_v1 { */ export interface Schema$RevisionTemplate { /** - * Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. + * Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. The following annotation keys set properties of the created revision: * `autoscaling.knative.dev/minScale` sets the minimum number of instances. * `autoscaling.knative.dev/maxScale` sets the maximum number of instances. * `run.googleapis.com/cloudsql-instances` sets Cloud SQL connections. Multiple values should be comma separated. * `run.googleapis.com/health-check-disabled`: if true, deploy-time startup probes will not run for this revision. * `run.googleapis.com/vpc-access-connector` sets a Serverless VPC Access connector. * `run.googleapis.com/vpc-access-egress` sets VPC egress. Supported values are `all-traffic`, `all` (deprecated), and `private-ranges-only`. `all-traffic` and `all` provide the same functionality. `all` is deprecated but will continue to be supported. Prefer `all-traffic`. */ metadata?: Schema$ObjectMeta; /** diff --git a/src/apis/run/v2.ts b/src/apis/run/v2.ts index 678d4b8b65..5274ad0650 100644 --- a/src/apis/run/v2.ts +++ b/src/apis/run/v2.ts @@ -133,7 +133,7 @@ export namespace run_v2 { */ breakglassJustification?: string | null; /** - * Optional. The path to a binary authorization policy. Format: projects/{project\}/platforms/cloudRun/{policy-name\} + * Optional. The path to a binary authorization policy. Format: `projects/{project\}/platforms/cloudRun/{policy-name\}` */ policy?: string | null; /** @@ -141,12 +141,66 @@ export namespace run_v2 { */ useDefault?: boolean | null; } + /** + * Describes the Build step of the function that builds a container from the given source. + */ + export interface Schema$GoogleCloudRunV2BuildConfig { + /** + * Optional. The base image used to build the function. + */ + baseImage?: string | null; + /** + * Optional. Sets whether the function will receive automatic base image updates. + */ + enableAutomaticUpdates?: boolean | null; + /** + * Optional. User-provided build-time environment variables for the function + */ + environmentVariables?: {[key: string]: string} | null; + /** + * Optional. The name of the function (as defined in source code) that will be executed. Defaults to the resource name suffix, if not specified. For backward compatibility, if function with given name is not found, then the system will try to use function named "function". + */ + functionTarget?: string | null; + /** + * Optional. Artifact Registry URI to store the built image. + */ + imageUri?: string | null; + /** + * Output only. The Cloud Build name of the latest successful deployment of the function. + */ + name?: string | null; + /** + * Optional. Service account to be used for building the container. The format of this field is `projects/{projectId\}/serviceAccounts/{serviceAccountEmail\}`. + */ + serviceAccount?: string | null; + /** + * The Cloud Storage bucket URI where the function source code is located. + */ + sourceLocation?: string | null; + /** + * Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the Cloud Run function. The format of this field is `projects/{project\}/locations/{region\}/workerPools/{workerPool\}` where {project\} and {region\} are the project id and region respectively where the worker pool is defined and {workerPool\} is the short name of the worker pool. + */ + workerPool?: string | null; + } + /** + * Build information of the image. + */ + export interface Schema$GoogleCloudRunV2BuildInfo { + /** + * Output only. Entry point of the function when the image is a Cloud Run function. + */ + functionTarget?: string | null; + /** + * Output only. Source code location of the image. + */ + sourceLocation?: string | null; + } /** * Build the source using Buildpacks. */ export interface Schema$GoogleCloudRunV2BuildpacksBuild { /** - * Optional. The base image used to opt into automatic base image updates. + * Optional. The base image to use for the build. */ baseImage?: string | null; /** @@ -165,6 +219,10 @@ export namespace run_v2 { * Optional. Name of the function target if the source is a function source. Required for function builds. */ functionTarget?: string | null; + /** + * Optional. project_descriptor stores the path to the project descriptor file. When empty, it means that there is no project descriptor file in the source. + */ + projectDescriptor?: string | null; /** * The runtime name, e.g. 'go113'. Leave blank for generic builds. */ @@ -237,6 +295,14 @@ export namespace run_v2 { * Arguments to the entrypoint. The docker image's CMD is used if this is not provided. */ args?: string[] | null; + /** + * Base image for this container. Only supported for services. If set. it indicates that the service is enrolled into automatic base image update. + */ + baseImageUri?: string | null; + /** + * Output only. The build info of the container image. + */ + buildInfo?: Schema$GoogleCloudRunV2BuildInfo; /** * Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided. */ @@ -383,6 +449,10 @@ export namespace run_v2 { * 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. */ createTime?: string | null; + /** + * Output only. Email address of the authenticated creator. + */ + creator?: string | null; /** * Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request. */ @@ -565,6 +635,10 @@ export namespace run_v2 { * Cloud Storage Bucket name. */ bucket?: string | null; + /** + * A list of additional flags to pass to the gcsfuse CLI. Options should be specified without the leading "--". + */ + mountOptions?: string[] | null; /** * If true, the volume will be mounted as read only for all mounts. */ @@ -1098,6 +1172,14 @@ export namespace run_v2 { * A reference to a customer managed encryption key (CMEK) to use to encrypt this container image. For more information, go to https://cloud.google.com/run/docs/securing/using-cmek */ encryptionKey?: string | null; + /** + * Optional. The action to take if the encryption key is revoked. + */ + encryptionKeyRevocationAction?: string | null; + /** + * Optional. If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour. + */ + encryptionKeyShutdownDuration?: string | null; /** * Optional. The sandbox environment to host this Revision. */ @@ -1111,7 +1193,7 @@ export namespace run_v2 { */ labels?: {[key: string]: string} | null; /** - * Optional. Sets the maximum number of requests that each serving instance can receive. If not specified or 0, defaults to 80 when requested CPU \>= 1 and defaults to 1 when requested CPU < 1. + * Optional. Sets the maximum number of requests that each serving instance can receive. If not specified or 0, concurrency defaults to 80 when requested `CPU \>= 1` and defaults to 1 when requested `CPU < 1`. */ maxInstanceRequestConcurrency?: number | null; /** @@ -1186,7 +1268,7 @@ export namespace run_v2 { */ export interface Schema$GoogleCloudRunV2SecretVolumeSource { /** - * Integer representation of mode bits to use on created files by default. Must be a value between 0000 and 0777 (octal), defaulting to 0444. Directories within the path are not affected by this setting. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 777 (a=rwx), set to 0777 (octal) or 511 (base-10). For chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set. This might be in conflict with other options that affect the file mode, like fsGroup, and as a result, other mode bits could be set. + * Integer representation of mode bits to use on created files by default. Must be a value between 0000 and 0777 (octal), defaulting to 0444. Directories within the path are not affected by this setting. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set. This might be in conflict with other options that affect the file mode, like fsGroup, and as a result, other mode bits could be set. */ defaultMode?: number | null; /** @@ -1210,6 +1292,10 @@ export namespace run_v2 { * Optional. Settings for the Binary Authorization feature. */ binaryAuthorization?: Schema$GoogleCloudRunV2BinaryAuthorization; + /** + * Optional. Configuration for building a Cloud Run function. + */ + buildConfig?: Schema$GoogleCloudRunV2BuildConfig; /** * Arbitrary identifier for the API client. */ @@ -1263,7 +1349,7 @@ export namespace run_v2 { */ ingress?: string | null; /** - * Optional. Disables IAM permission check for run.routes.invoke for callers of this service. This setting should not be used with external ingress. + * Optional. Disables IAM permission check for run.routes.invoke for callers of this service. This feature is available by invitation only. For more information, visit https://cloud.google.com/run/docs/securing/managing-access#invoker_check. */ invokerIamDisabled?: boolean | null; /** @@ -1344,7 +1430,7 @@ export namespace run_v2 { */ export interface Schema$GoogleCloudRunV2ServiceMesh { /** - * The Mesh resource name. Format: projects/{project\}/locations/global/meshes/{mesh\}, where {project\} can be project id or number. + * The Mesh resource name. Format: `projects/{project\}/locations/global/meshes/{mesh\}`, where `{project\}` can be project id or number. */ mesh?: string | null; } @@ -1352,6 +1438,14 @@ export namespace run_v2 { * Scaling settings applied at the service level rather than at the revision level. */ export interface Schema$GoogleCloudRunV2ServiceScaling { + /** + * Optional. total instance count for the service in manual scaling mode. This number of instances is divided among all revisions with specified traffic based on the percent of traffic they are receiving. + */ + manualInstanceCount?: number | null; + /** + * Optional. total max instances for the service. This number of instances is divided among all revisions with specified traffic based on the percent of traffic they are receiving. + */ + maxInstanceCount?: number | null; /** * Optional. total min instances for the service. This number of instances is divided among all revisions with specified traffic based on the percent of traffic they are receiving. */ @@ -1407,7 +1501,7 @@ export namespace run_v2 { */ tags?: string[] | null; /** - * Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project\}/locations/{region\}/workerPools/{workerPool\}` where {project\} and {region\} are the project id and region respectively where the worker pool is defined and {workerPool\} is the short name of the worker pool. + * Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project\}/locations/{region\}/workerPools/{workerPool\}` where `{project\}` and `{region\}` are the project id and region respectively where the worker pool is defined and `{workerPool\}` is the short name of the worker pool. */ workerPool?: string | null; } @@ -1667,7 +1761,7 @@ export namespace run_v2 { */ export interface Schema$GoogleCloudRunV2VersionToPath { /** - * Integer octal mode bits to use on this file, must be a value between 01 and 0777 (octal). If 0 or not set, the Volume's default mode will be used. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 777 (a=rwx), set to 0777 (octal) or 511 (base-10). For chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set. + * Integer octal mode bits to use on this file, must be a value between 01 and 0777 (octal). If 0 or not set, the Volume's default mode will be used. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set. */ mode?: number | null; /** @@ -1726,7 +1820,7 @@ export namespace run_v2 { */ export interface Schema$GoogleCloudRunV2VpcAccess { /** - * VPC Access connector name. Format: projects/{project\}/locations/{location\}/connectors/{connector\}, where {project\} can be project id or number. For more information on sending traffic to a VPC network via a connector, visit https://cloud.google.com/run/docs/configuring/vpc-connectors. + * VPC Access connector name. Format: `projects/{project\}/locations/{location\}/connectors/{connector\}`, where `{project\}` can be project id or number. For more information on sending traffic to a VPC network via a connector, visit https://cloud.google.com/run/docs/configuring/vpc-connectors. */ connector?: string | null; /** @@ -1793,6 +1887,10 @@ export namespace run_v2 { * Artifacts produced by a build that should be uploaded upon successful completion of all build steps. */ export interface Schema$GoogleDevtoolsCloudbuildV1Artifacts { + /** + * Optional. A list of Go modules to be uploaded to Artifact Registry upon successful completion of all build steps. If any objects fail to be pushed, the build is marked FAILURE. + */ + goModules?: Schema$GoogleDevtoolsCloudbuildV1GoModule[]; /** * A list of images to be pushed upon the successful completion of all build steps. The images will be pushed using the builder service account's credentials. The digests of the pushed images will be stored in the Build resource's results field. If any of the images fail to be pushed, the build is marked FAILURE. */ @@ -1985,6 +2083,10 @@ export namespace run_v2 { * Option to specify whether or not to apply bash style string operations to the substitutions. NOTE: this is always enabled for triggered builds and cannot be overridden in the build configuration file. */ dynamicSubstitutions?: boolean | null; + /** + * Optional. Option to specify whether structured logging is enabled. If true, JSON-formatted logs are parsed as structured logs. + */ + enableStructuredLogging?: boolean | null; /** * A list of global environment variable definitions that will exist for all build steps in this build. If a variable is defined in both globally and in a build step, the variable will use the build step value. The elements are of the form "KEY=VALUE" for the environment variable "KEY" being given the value "VALUE". */ @@ -2206,6 +2308,35 @@ export namespace run_v2 { */ url?: string | null; } + /** + * Go module to upload to Artifact Registry upon successful completion of all build steps. A module refers to all dependencies in a go.mod file. + */ + export interface Schema$GoogleDevtoolsCloudbuildV1GoModule { + /** + * Optional. The Go module's "module path". e.g. example.com/foo/v2 + */ + modulePath?: string | null; + /** + * Optional. The Go module's semantic version in the form vX.Y.Z. e.g. v0.1.1 Pre-release identifiers can also be added by appending a dash and dot separated ASCII alphanumeric characters and hyphens. e.g. v0.2.3-alpha.x.12m.5 + */ + moduleVersion?: string | null; + /** + * Optional. Location of the Artifact Registry repository. i.e. us-east1 Defaults to the build’s location. + */ + repositoryLocation?: string | null; + /** + * Optional. Artifact Registry repository name. Specified Go modules will be zipped and uploaded to Artifact Registry with this location as a prefix. e.g. my-go-repo + */ + repositoryName?: string | null; + /** + * Optional. Project ID of the Artifact Registry repository. Defaults to the build project. + */ + repositoryProjectId?: string | null; + /** + * Optional. Source path of the go.mod file in the build's workspace. If not specified, this will default to the current directory. e.g. ~/code/go/mypackage + */ + sourcePath?: string | null; + } /** * Container message for hash values. */ @@ -2358,6 +2489,10 @@ export namespace run_v2 { * List of build step outputs, produced by builder images, in the order corresponding to build step indices. [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) can produce this output by writing to `$BUILDER_OUTPUT/output`. Only the first 50KB of data is stored. Note that the `$BUILDER_OUTPUT` variable is read-only and can't be substituted. */ buildStepOutputs?: string[] | null; + /** + * Optional. Go module artifacts uploaded to Artifact Registry at the end of the build. + */ + goModules?: Schema$GoogleDevtoolsCloudbuildV1UploadedGoModule[]; /** * Container images that were built as a part of the build. */ @@ -2529,6 +2664,23 @@ export namespace run_v2 { */ startTime?: string | null; } + /** + * A Go module artifact uploaded to Artifact Registry using the GoModule directive. + */ + export interface Schema$GoogleDevtoolsCloudbuildV1UploadedGoModule { + /** + * Hash types and values of the Go Module Artifact. + */ + fileHashes?: Schema$GoogleDevtoolsCloudbuildV1FileHashes; + /** + * Output only. Stores timing information for pushing the specified artifact. + */ + pushTiming?: Schema$GoogleDevtoolsCloudbuildV1TimeSpan; + /** + * URI of the uploaded artifact. + */ + uri?: string | null; + } /** * A Maven artifact uploaded using the MavenArtifact directive. */ @@ -2799,23 +2951,23 @@ export namespace run_v2 { */ export interface Schema$UtilStatusProto { /** - * The canonical error code (see codes.proto) that most closely corresponds to this status. This may be missing, and in the common case of the generic space, it definitely will be. + * The canonical error code (see codes.proto) that most closely corresponds to this status. This may be missing, and in the common case of the generic space, it definitely will be. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional int32 canonical_code = 6; */ canonicalCode?: number | null; /** - * Numeric code drawn from the space specified below. Often, this is the canonical error space, and code is drawn from google3/util/task/codes.proto + * Numeric code drawn from the space specified below. Often, this is the canonical error space, and code is drawn from google3/util/task/codes.proto copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional int32 code = 1; */ code?: number | null; /** - * Detail message + * Detail message copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional string message = 3; */ message?: string | null; /** - * message_set associates an arbitrary proto message with the status. + * message_set associates an arbitrary proto message with the status. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional proto2.bridge.MessageSet message_set = 5; */ messageSet?: Schema$Proto2BridgeMessageSet; /** - * The following are usually only present when code != 0 Space to which this status belongs + * The following are usually only present when code != 0 Space to which this status belongs copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional string space = 2; */ space?: string | null; } @@ -2835,6 +2987,7 @@ export namespace run_v2 { jobs: Resource$Projects$Locations$Jobs; operations: Resource$Projects$Locations$Operations; services: Resource$Projects$Locations$Services; + workerPools: Resource$Projects$Locations$Workerpools; constructor(context: APIRequestContext) { this.context = context; this.builds = new Resource$Projects$Locations$Builds(this.context); @@ -2843,6 +2996,9 @@ export namespace run_v2 { this.context ); this.services = new Resource$Projects$Locations$Services(this.context); + this.workerPools = new Resource$Projects$Locations$Workerpools( + this.context + ); } /** @@ -3369,7 +3525,7 @@ export namespace run_v2 { export interface Params$Resource$Projects$Locations$Builds$Submit extends StandardParameters { /** - * Required. The project and location to build in. Location must be a region, e.g., 'us-central1' or 'global' if the global builder is to be used. Format: projects/{project\}/locations/{location\} + * Required. The project and location to build in. Location must be a region, e.g., 'us-central1' or 'global' if the global builder is to be used. Format: `projects/{project\}/locations/{location\}` */ parent?: string; @@ -6866,4 +7022,346 @@ export namespace run_v2 { */ showDeleted?: boolean; } + + export class Resource$Projects$Locations$Workerpools { + context: APIRequestContext; + revisions: Resource$Projects$Locations$Workerpools$Revisions; + constructor(context: APIRequestContext) { + this.context = context; + this.revisions = new Resource$Projects$Locations$Workerpools$Revisions( + this.context + ); + } + } + + export class Resource$Projects$Locations$Workerpools$Revisions { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Deletes a Revision. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + delete( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Delete, + options: StreamMethodOptions + ): GaxiosPromise; + delete( + params?: Params$Resource$Projects$Locations$Workerpools$Revisions$Delete, + options?: MethodOptions + ): GaxiosPromise; + delete( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Delete, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Delete, + callback: BodyResponseCallback + ): void; + delete( + callback: BodyResponseCallback + ): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Workerpools$Revisions$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Workerpools$Revisions$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Workerpools$Revisions$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://run.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Gets information about a Revision. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Get, + options: StreamMethodOptions + ): GaxiosPromise; + get( + params?: Params$Resource$Projects$Locations$Workerpools$Revisions$Get, + options?: MethodOptions + ): GaxiosPromise; + get( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Get, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Workerpools$Revisions$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Workerpools$Revisions$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Workerpools$Revisions$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://run.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists Revisions from a given Service, or from a given location. Results are sorted by creation time, descending. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Projects$Locations$Workerpools$Revisions$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Workerpools$Revisions$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Workerpools$Revisions$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Workerpools$Revisions$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Workerpools$Revisions$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://run.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2/{+parent}/revisions').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Workerpools$Revisions$Delete + extends StandardParameters { + /** + * A system-generated fingerprint for this version of the resource. This may be used to detect modification conflict during updates. + */ + etag?: string; + /** + * Required. The name of the Revision to delete. Format: projects/{project\}/locations/{location\}/services/{service\}/revisions/{revision\} + */ + name?: string; + /** + * Indicates that the request should be validated without actually deleting any resources. + */ + validateOnly?: boolean; + } + export interface Params$Resource$Projects$Locations$Workerpools$Revisions$Get + extends StandardParameters { + /** + * Required. The full name of the Revision. Format: projects/{project\}/locations/{location\}/services/{service\}/revisions/{revision\} + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Workerpools$Revisions$List + extends StandardParameters { + /** + * Maximum number of revisions to return in this call. + */ + pageSize?: number; + /** + * A page token received from a previous call to ListRevisions. All other parameters must match. + */ + pageToken?: string; + /** + * 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\} + */ + parent?: string; + /** + * If true, returns deleted (but unexpired) resources along with active ones. + */ + showDeleted?: boolean; + } }