update all APIs

Like documented in the README

```
rm -f .api.deps .cli.deps && FETCH_APIS=1 make update-json -j8
```
This commit is contained in:
Sebastian Thiel
2024-03-05 18:54:36 +01:00
parent 8a12e9d47e
commit ca974aa0a5
347 changed files with 202580 additions and 50157 deletions

View File

@@ -154,6 +154,62 @@
"resources": {
"functions": {
"methods": {
"abortFunctionUpgrade": {
"description": "Aborts generation upgrade process for a function with the given name from the specified project. Deletes all 2nd Gen copy related configuration and resources which were created during the upgrade process.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:abortFunctionUpgrade",
"httpMethod": "POST",
"id": "cloudfunctions.projects.locations.functions.abortFunctionUpgrade",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the function for which upgrade should be aborted.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/functions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2alpha/{+name}:abortFunctionUpgrade",
"request": {
"$ref": "AbortFunctionUpgradeRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"commitFunctionUpgrade": {
"description": "Finalizes the upgrade after which function upgrade can not be rolled back. This is the last step of the multi step process to upgrade 1st Gen functions to 2nd Gen. Deletes all original 1st Gen related configuration and resources.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:commitFunctionUpgrade",
"httpMethod": "POST",
"id": "cloudfunctions.projects.locations.functions.commitFunctionUpgrade",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the function for which upgrade should be finalized.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/functions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2alpha/{+name}:commitFunctionUpgrade",
"request": {
"$ref": "CommitFunctionUpgradeRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"create": {
"description": "Creates a new function. If a function with the given name already exists in the specified project, the long running operation will return `ALREADY_EXISTS` error.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions",
@@ -241,7 +297,7 @@
]
},
"generateUploadUrl": {
"description": "Returns a signed URL for uploading a function source code. For more information about the signed URL usage see: https://cloud.google.com/storage/docs/access-control/signed-urls. Once the function source code upload is complete, the used signed URL should be provided in CreateFunction or UpdateFunction request as a reference to the function source code. When uploading source code to the generated signed URL, please follow these restrictions: * Source file type should be a zip file. * No credentials should be attached - the signed URLs provide access to the target bucket using internal service identity; if credentials were attached, the identity from the credentials would be used, but that identity does not have permissions to upload files to the URL. When making a HTTP PUT request, these two headers need to be specified: * `content-type: application/zip` And this header SHOULD NOT be specified: * `Authorization: Bearer YOUR_TOKEN`",
"description": "Returns a signed URL for uploading a function source code. For more information about the signed URL usage see: https://cloud.google.com/storage/docs/access-control/signed-urls. Once the function source code upload is complete, the used signed URL should be provided in CreateFunction or UpdateFunction request as a reference to the function source code. When uploading source code to the generated signed URL, please follow these restrictions: * Source file type should be a zip file. * No credentials should be attached - the signed URLs provide access to the target bucket using internal service identity; if credentials were attached, the identity from the credentials would be used, but that identity does not have permissions to upload files to the URL. When making a HTTP PUT request, specify this header: * `content-type: application/zip` Do not specify this header: * `Authorization: Bearer YOUR_TOKEN`",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions:generateUploadUrl",
"httpMethod": "POST",
"id": "cloudfunctions.projects.locations.functions.generateUploadUrl",
@@ -344,7 +400,7 @@
"type": "string"
},
"pageSize": {
"description": "Maximum number of functions to return per call.",
"description": "Maximum number of functions to return per call. The largest allowed page_size is 1,000, if the page_size is omitted or specified as greater than 1,000 then it will be replaced as 1,000. The size of the list response can be less than specified when used with filters.",
"format": "int32",
"location": "query",
"type": "integer"
@@ -404,6 +460,62 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
"redirectFunctionUpgradeTraffic": {
"description": "Changes the traffic target of a function from the original 1st Gen function to the 2nd Gen copy. This is the second step of the multi step process to upgrade 1st Gen functions to 2nd Gen. After this operation, all new traffic will be served by 2nd Gen copy.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:redirectFunctionUpgradeTraffic",
"httpMethod": "POST",
"id": "cloudfunctions.projects.locations.functions.redirectFunctionUpgradeTraffic",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the function for which traffic target should be changed to 2nd Gen from 1st Gen.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/functions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2alpha/{+name}:redirectFunctionUpgradeTraffic",
"request": {
"$ref": "RedirectFunctionUpgradeTrafficRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"rollbackFunctionUpgradeTraffic": {
"description": "Reverts the traffic target of a function from the 2nd Gen copy to the original 1st Gen function. After this operation, all new traffic would be served by the 1st Gen.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:rollbackFunctionUpgradeTraffic",
"httpMethod": "POST",
"id": "cloudfunctions.projects.locations.functions.rollbackFunctionUpgradeTraffic",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the function for which traffic target should be changed back to 1st Gen from 2nd Gen.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/functions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2alpha/{+name}:rollbackFunctionUpgradeTraffic",
"request": {
"$ref": "RollbackFunctionUpgradeTrafficRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"setIamPolicy": {
"description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:setIamPolicy",
@@ -432,6 +544,34 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
"setupFunctionUpgradeConfig": {
"description": "Creates a 2nd Gen copy of the function configuration based on the 1st Gen function with the given name. This is the first step of the multi step process to upgrade 1st Gen functions to 2nd Gen. Only 2nd Gen configuration is setup as part of this request and traffic continues to be served by 1st Gen.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:setupFunctionUpgradeConfig",
"httpMethod": "POST",
"id": "cloudfunctions.projects.locations.functions.setupFunctionUpgradeConfig",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the function which should have configuration copied for upgrade.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/functions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2alpha/{+name}:setupFunctionUpgradeConfig",
"request": {
"$ref": "SetupFunctionUpgradeConfigRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"testIamPermissions": {
"description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:testIamPermissions",
@@ -490,7 +630,7 @@
]
},
"list": {
"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.",
"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/operations",
"httpMethod": "GET",
"id": "cloudfunctions.projects.locations.operations.list",
@@ -499,25 +639,25 @@
],
"parameters": {
"filter": {
"description": "Required. A filter for matching the requested operations. The supported formats of *filter* are: To query for a specific function: project:*,location:*,function:* To query for all of the latest operations for a project: project:*,latest:true",
"description": "The standard list filter.",
"location": "query",
"type": "string"
},
"name": {
"description": "Must not be set.",
"description": "The name of the operation's parent resource.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "The maximum number of records that should be returned. Requested page size cannot exceed 100. If not set, the default page size is 100. Pagination is only supported when querying for a specific function.",
"description": "The standard list page size.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Token identifying which result to start with, which is returned by a previous list call. Pagination is only supported when querying for a specific function.",
"description": "The standard list page token.",
"location": "query",
"type": "string"
}
@@ -571,9 +711,15 @@
}
}
},
"revision": "20230119",
"revision": "20240222",
"rootUrl": "https://cloudfunctions.googleapis.com/",
"schemas": {
"AbortFunctionUpgradeRequest": {
"description": "Request for the `AbortFunctionUpgrade` method.",
"id": "AbortFunctionUpgradeRequest",
"properties": {},
"type": "object"
},
"AuditConfig": {
"description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.",
"id": "AuditConfig",
@@ -622,6 +768,12 @@
},
"type": "object"
},
"AutomaticUpdatePolicy": {
"description": "Security patches are applied automatically to the runtime without requiring the function to be redeployed.",
"id": "AutomaticUpdatePolicy",
"properties": {},
"type": "object"
},
"Binding": {
"description": "Associates `members`, or principals, with a `role`.",
"id": "Binding",
@@ -631,14 +783,14 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
"description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.",
"items": {
"type": "string"
},
"type": "array"
},
"role": {
"description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.",
"description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).",
"type": "string"
}
},
@@ -648,17 +800,16 @@
"description": "Describes the Build step of the function that builds a container from the given source.",
"id": "BuildConfig",
"properties": {
"automaticUpdatePolicy": {
"$ref": "AutomaticUpdatePolicy"
},
"build": {
"description": "Output only. The Cloud Build name of the latest successful deployment of the function.",
"readOnly": true,
"type": "string"
},
"buildpackStack": {
"description": "Specifies one of the Google provided buildpack stacks.",
"type": "string"
},
"dockerRegistry": {
"description": "Optional. Docker Registry to use for this deployment. This configuration is only applicable to 1st Gen functions, 2nd Gen functions can only use Artifact Registry. If `docker_repository` field is specified, this field will be automatically set as `ARTIFACT_REGISTRY`. If unspecified, it currently defaults to `CONTAINER_REGISTRY`. This field may be overridden by the backend for eligible deployments.",
"description": "Docker Registry to use for this deployment. This configuration is only applicable to 1st Gen functions, 2nd Gen functions can only use Artifact Registry. If `docker_repository` field is specified, this field will be automatically set as `ARTIFACT_REGISTRY`. If unspecified, it currently defaults to `CONTAINER_REGISTRY`. This field may be overridden by the backend for eligible deployments.",
"enum": [
"DOCKER_REGISTRY_UNSPECIFIED",
"CONTAINER_REGISTRY",
@@ -672,7 +823,7 @@
"type": "string"
},
"dockerRepository": {
"description": "User managed repository created in Artifact Registry optionally with a customer managed encryption key. This is the repository to which the function docker image will be pushed after it is built by Cloud Build. If unspecified, GCF will create and use a repository named 'gcf-artifacts' for every deployed region. It must match the pattern `projects/{project}/locations/{location}/repositories/{repository}`. Cross-project repositories are not supported. Cross-location repositories are not supported. Repository format must be 'DOCKER'.",
"description": "Repository in Artifact Registry to which the function docker image will be pushed after it is built by Cloud Build. If specified by user, it is created and managed by user with a customer managed encryption key. Otherwise, GCF will create and use a repository named 'gcf-artifacts' for every deployed region. It must match the pattern `projects/{project}/locations/{location}/repositories/{repository}`. Cross-project repositories are not supported. Cross-location repositories are not supported. Repository format must be 'DOCKER'.",
"type": "string"
},
"entryPoint": {
@@ -686,10 +837,17 @@
"description": "User-provided build-time environment variables for the function",
"type": "object"
},
"onDeployUpdatePolicy": {
"$ref": "OnDeployUpdatePolicy"
},
"runtime": {
"description": "The runtime in which to run the function. Required when deploying a new function, optional when updating an existing function. For a complete list of possible choices, see the [`gcloud` command reference](https://cloud.google.com/sdk/gcloud/reference/functions/deploy#--runtime).",
"type": "string"
},
"serviceAccount": {
"description": "[Preview] Service account to be used for building the container",
"type": "string"
},
"source": {
"$ref": "Source",
"description": "The location of the function source code."
@@ -699,6 +857,10 @@
"description": "Output only. A permanent fixed identifier for source.",
"readOnly": true
},
"sourceToken": {
"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
"type": "string"
},
"workerPool": {
"description": "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. If the project id is not the same as the function, then the Cloud Functions Service Agent (service-@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role Cloud Build Custom Workers Builder (roles/cloudbuild.customworkers.builder) in the project.",
"type": "string"
@@ -706,6 +868,34 @@
},
"type": "object"
},
"CommitFunctionUpgradeRequest": {
"description": "Request for the `CommitFunctionUpgrade` method.",
"id": "CommitFunctionUpgradeRequest",
"properties": {},
"type": "object"
},
"Date": {
"description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp",
"id": "Date",
"properties": {
"day": {
"description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.",
"format": "int32",
"type": "integer"
},
"month": {
"description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.",
"format": "int32",
"type": "integer"
},
"year": {
"description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"EventFilter": {
"description": "Filters events based on exact matches on the CloudEvents attributes.",
"id": "EventFilter",
@@ -762,6 +952,10 @@
],
"type": "string"
},
"service": {
"description": "Optional. The hostname of the service that 1st Gen function should be observed. If no string is provided, the default service implementing the API will be used. For example, `storage.googleapis.com` is the default for all event types in the `google.storage` namespace. The field is only applicable to 1st Gen functions.",
"type": "string"
},
"serviceAccountEmail": {
"description": "Optional. The email of the trigger's service account. The service account must have permission to invoke Cloud Run services, the permission is `run.routes.invoke`. If empty, defaults to the Compute Engine default service account: `{project_number}-compute@developer.gserviceaccount.com`.",
"type": "string"
@@ -809,6 +1003,12 @@
"$ref": "BuildConfig",
"description": "Describes the Build step of the function that builds a container from the given source."
},
"createTime": {
"description": "Output only. The create timestamp of a Cloud Function. This is only applicable to 2nd Gen functions.",
"format": "google-datetime",
"readOnly": true,
"type": "string"
},
"description": {
"description": "User-provided description of a function.",
"type": "string"
@@ -831,6 +1031,10 @@
"$ref": "EventTrigger",
"description": "An Eventarc trigger managed by Google Cloud Functions that fires events in response to a condition in another service."
},
"kmsKeyName": {
"description": "[Preview] Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt function resources. It must match the pattern `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.",
"type": "string"
},
"labels": {
"additionalProperties": {
"type": "string"
@@ -842,6 +1046,11 @@
"description": "A user-defined name of the function. Function names must be unique globally and match pattern `projects/*/locations/*/functions/*`",
"type": "string"
},
"satisfiesPzs": {
"description": "Output only. Reserved for future use.",
"readOnly": true,
"type": "boolean"
},
"serviceConfig": {
"$ref": "ServiceConfig",
"description": "Describes the Service being deployed. Currently deploys services to Cloud Run (fully managed)."
@@ -880,6 +1089,16 @@
"format": "google-datetime",
"readOnly": true,
"type": "string"
},
"upgradeInfo": {
"$ref": "UpgradeInfo",
"description": "Output only. UpgradeInfo for this Cloud Function",
"readOnly": true
},
"url": {
"description": "Output only. The deployed url for the function.",
"readOnly": true,
"type": "string"
}
},
"type": "object"
@@ -904,7 +1123,26 @@
"GenerateUploadUrlRequest": {
"description": "Request of `GenerateSourceUploadUrl` method.",
"id": "GenerateUploadUrlRequest",
"properties": {},
"properties": {
"environment": {
"description": "The function environment the generated upload url will be used for. The upload url for 2nd Gen functions can also be used for 1st gen functions, but not vice versa. If not specified, 2nd generation-style upload URLs are generated.",
"enum": [
"ENVIRONMENT_UNSPECIFIED",
"GEN_1",
"GEN_2"
],
"enumDescriptions": [
"Unspecified",
"Gen 1",
"Gen 2"
],
"type": "string"
},
"kmsKeyName": {
"description": "[Preview] Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt function source code objects in intermediate Cloud Storage buckets. When you generate an upload url and upload your source code, it gets copied to an intermediate Cloud Storage bucket. The source code is then copied to a versioned directory in the sources bucket in the consumer project during the function deployment. It must match the pattern `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. The Google Cloud Functions service account (service-{project_number}@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role 'Cloud KMS CryptoKey Encrypter/Decrypter (roles/cloudkms.cryptoKeyEncrypterDecrypter)' on the Key/KeyRing/Project/Organization (least access preferred).",
"type": "string"
}
},
"type": "object"
},
"GenerateUploadUrlResponse": {
@@ -922,6 +1160,30 @@
},
"type": "object"
},
"GoogleCloudFunctionsV2LocationMetadata": {
"description": "Extra GCF specific location information.",
"id": "GoogleCloudFunctionsV2LocationMetadata",
"properties": {
"environments": {
"description": "The Cloud Function environments this location supports.",
"items": {
"enum": [
"ENVIRONMENT_UNSPECIFIED",
"GEN_1",
"GEN_2"
],
"enumDescriptions": [
"Unspecified",
"Gen 1",
"Gen 2"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudFunctionsV2OperationMetadata": {
"description": "Represents the metadata of the long-running operation.",
"id": "GoogleCloudFunctionsV2OperationMetadata",
@@ -931,7 +1193,7 @@
"type": "string"
},
"cancelRequested": {
"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"type": "boolean"
},
"createTime": {
@@ -944,6 +1206,32 @@
"format": "google-datetime",
"type": "string"
},
"operationType": {
"description": "The operation type.",
"enum": [
"OPERATIONTYPE_UNSPECIFIED",
"CREATE_FUNCTION",
"UPDATE_FUNCTION",
"DELETE_FUNCTION",
"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
"SETUP_FUNCTION_UPGRADE_CONFIG",
"ABORT_FUNCTION_UPGRADE",
"COMMIT_FUNCTION_UPGRADE"
],
"enumDescriptions": [
"Unspecified",
"CreateFunction",
"UpdateFunction",
"DeleteFunction",
"RedirectFunctionUpgradeTraffic",
"RollbackFunctionUpgradeTraffic",
"SetupFunctionUpgradeConfig",
"AbortFunctionUpgrade",
"CommitFunctionUpgrade"
],
"type": "string"
},
"requestResource": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
@@ -952,6 +1240,10 @@
"description": "The original request that started the operation.",
"type": "object"
},
"sourceToken": {
"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
"type": "string"
},
"stages": {
"description": "Mechanism for reporting in-progress stages",
"items": {
@@ -1069,6 +1361,30 @@
},
"type": "object"
},
"GoogleCloudFunctionsV2alphaLocationMetadata": {
"description": "Extra GCF specific location information.",
"id": "GoogleCloudFunctionsV2alphaLocationMetadata",
"properties": {
"environments": {
"description": "The Cloud Function environments this location supports.",
"items": {
"enum": [
"ENVIRONMENT_UNSPECIFIED",
"GEN_1",
"GEN_2"
],
"enumDescriptions": [
"Unspecified",
"Gen 1",
"Gen 2"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudFunctionsV2alphaOperationMetadata": {
"description": "Represents the metadata of the long-running operation.",
"id": "GoogleCloudFunctionsV2alphaOperationMetadata",
@@ -1078,7 +1394,7 @@
"type": "string"
},
"cancelRequested": {
"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"type": "boolean"
},
"createTime": {
@@ -1091,6 +1407,32 @@
"format": "google-datetime",
"type": "string"
},
"operationType": {
"description": "The operation type.",
"enum": [
"OPERATIONTYPE_UNSPECIFIED",
"CREATE_FUNCTION",
"UPDATE_FUNCTION",
"DELETE_FUNCTION",
"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
"SETUP_FUNCTION_UPGRADE_CONFIG",
"ABORT_FUNCTION_UPGRADE",
"COMMIT_FUNCTION_UPGRADE"
],
"enumDescriptions": [
"Unspecified",
"CreateFunction",
"UpdateFunction",
"DeleteFunction",
"RedirectFunctionUpgradeTraffic",
"RollbackFunctionUpgradeTraffic",
"SetupFunctionUpgradeConfig",
"AbortFunctionUpgrade",
"CommitFunctionUpgrade"
],
"type": "string"
},
"requestResource": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
@@ -1099,6 +1441,10 @@
"description": "The original request that started the operation.",
"type": "object"
},
"sourceToken": {
"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
"type": "string"
},
"stages": {
"description": "Mechanism for reporting in-progress stages",
"items": {
@@ -1216,6 +1562,30 @@
},
"type": "object"
},
"GoogleCloudFunctionsV2betaLocationMetadata": {
"description": "Extra GCF specific location information.",
"id": "GoogleCloudFunctionsV2betaLocationMetadata",
"properties": {
"environments": {
"description": "The Cloud Function environments this location supports.",
"items": {
"enum": [
"ENVIRONMENT_UNSPECIFIED",
"GEN_1",
"GEN_2"
],
"enumDescriptions": [
"Unspecified",
"Gen 1",
"Gen 2"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudFunctionsV2betaOperationMetadata": {
"description": "Represents the metadata of the long-running operation.",
"id": "GoogleCloudFunctionsV2betaOperationMetadata",
@@ -1225,7 +1595,7 @@
"type": "string"
},
"cancelRequested": {
"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
"type": "boolean"
},
"createTime": {
@@ -1238,6 +1608,32 @@
"format": "google-datetime",
"type": "string"
},
"operationType": {
"description": "The operation type.",
"enum": [
"OPERATIONTYPE_UNSPECIFIED",
"CREATE_FUNCTION",
"UPDATE_FUNCTION",
"DELETE_FUNCTION",
"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
"SETUP_FUNCTION_UPGRADE_CONFIG",
"ABORT_FUNCTION_UPGRADE",
"COMMIT_FUNCTION_UPGRADE"
],
"enumDescriptions": [
"Unspecified",
"CreateFunction",
"UpdateFunction",
"DeleteFunction",
"RedirectFunctionUpgradeTraffic",
"RollbackFunctionUpgradeTraffic",
"SetupFunctionUpgradeConfig",
"AbortFunctionUpgrade",
"CommitFunctionUpgrade"
],
"type": "string"
},
"requestResource": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
@@ -1246,6 +1642,10 @@
"description": "The original request that started the operation.",
"type": "object"
},
"sourceToken": {
"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
"type": "string"
},
"stages": {
"description": "Mechanism for reporting in-progress stages",
"items": {
@@ -1439,7 +1839,7 @@
"type": "object"
},
"Location": {
"description": "A resource that represents Google Cloud Platform location.",
"description": "A resource that represents a Google Cloud location.",
"id": "Location",
"properties": {
"displayName": {
@@ -1472,6 +1872,18 @@
},
"type": "object"
},
"OnDeployUpdatePolicy": {
"description": "Security patches are only applied when a function is redeployed.",
"id": "OnDeployUpdatePolicy",
"properties": {
"runtimeVersion": {
"description": "Output only. contains the runtime version which was used during latest function deployment.",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"Operation": {
"description": "This resource represents a long-running operation that is the result of a network API call.",
"id": "Operation",
@@ -1501,7 +1913,7 @@
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
"description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
"type": "object"
}
},
@@ -1565,7 +1977,7 @@
"type": "object"
},
"Policy": {
"description": "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/).",
"description": "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/).",
"id": "Policy",
"properties": {
"auditConfigs": {
@@ -1595,6 +2007,12 @@
},
"type": "object"
},
"RedirectFunctionUpgradeTrafficRequest": {
"description": "Request for the `RedirectFunctionUpgradeTraffic` method.",
"id": "RedirectFunctionUpgradeTrafficRequest",
"properties": {},
"type": "object"
},
"RepoSource": {
"description": "Location of the source in a Google Cloud Source Repository.",
"id": "RepoSource",
@@ -1611,10 +2029,6 @@
"description": "Directory, relative to the source root, in which to run the build. This must be a relative path. If a step's `dir` is specified and is an absolute path, this value is ignored for that step's execution. eg. helloworld (no leading slash allowed)",
"type": "string"
},
"invertRegex": {
"description": "Only trigger a build if the revision regex does NOT match the revision regex.",
"type": "boolean"
},
"projectId": {
"description": "ID of the project that owns the Cloud Source Repository. If omitted, the project ID requesting the build is assumed.",
"type": "string"
@@ -1630,10 +2044,24 @@
},
"type": "object"
},
"RollbackFunctionUpgradeTrafficRequest": {
"description": "Request for the `RollbackFunctionUpgradeTraffic` method.",
"id": "RollbackFunctionUpgradeTrafficRequest",
"properties": {},
"type": "object"
},
"Runtime": {
"description": "Describes a runtime and any special information (e.g., deprecation status) related to it.",
"id": "Runtime",
"properties": {
"decommissionDate": {
"$ref": "Date",
"description": "Decommission date for the runtime."
},
"deprecationDate": {
"$ref": "Date",
"description": "Deprecation date for the runtime."
},
"displayName": {
"description": "The user facing name, eg 'Go 1.13', 'Node.js 12', etc.",
"type": "string"
@@ -1753,7 +2181,7 @@
"type": "object"
},
"ServiceConfig": {
"description": "Describes the Service being deployed. Currently Supported : Cloud Run (fully managed). Next tag: 23",
"description": "Describes the Service being deployed. Currently Supported : Cloud Run (fully managed).",
"id": "ServiceConfig",
"properties": {
"allTrafficOnLatestRevision": {
@@ -1895,10 +2323,20 @@
},
"type": "object"
},
"SetupFunctionUpgradeConfigRequest": {
"description": "Request for the `SetupFunctionUpgradeConfig` method.",
"id": "SetupFunctionUpgradeConfigRequest",
"properties": {},
"type": "object"
},
"Source": {
"description": "The location of the function source code.",
"id": "Source",
"properties": {
"gitUri": {
"description": "If provided, get the source from GitHub repository. This option is valid only for GCF 1st Gen function. Example: https://github.com///blob//",
"type": "string"
},
"repoSource": {
"$ref": "RepoSource",
"description": "If provided, get the source from this location in a Cloud Source Repository."
@@ -1914,6 +2352,10 @@
"description": "Provenance of the source. Ways to find the original source, or verify that some source was used for this build.",
"id": "SourceProvenance",
"properties": {
"gitUri": {
"description": "A copy of the build's `source.git_uri`, if exists, with any commits resolved.",
"type": "string"
},
"resolvedRepoSource": {
"$ref": "RepoSource",
"description": "A copy of the build's `source.repo_source`, if exists, with any revisions resolved."
@@ -1999,6 +2441,53 @@
}
},
"type": "object"
},
"UpgradeInfo": {
"description": "Information related to: * A function's eligibility for 1st Gen to 2nd Gen migration * Current state of migration for function undergoing migration.",
"id": "UpgradeInfo",
"properties": {
"buildConfig": {
"$ref": "BuildConfig",
"description": "Describes the Build step of the function that builds a container to prepare for 2nd gen upgrade."
},
"eventTrigger": {
"$ref": "EventTrigger",
"description": "Describes the Event trigger which has been setup to prepare for 2nd gen upgrade."
},
"serviceConfig": {
"$ref": "ServiceConfig",
"description": "Describes the Cloud Run service which has been setup to prepare for 2nd gen upgrade."
},
"upgradeState": {
"description": "UpgradeState of the function",
"enum": [
"UPGRADE_STATE_UNSPECIFIED",
"ELIGIBLE_FOR_2ND_GEN_UPGRADE",
"UPGRADE_OPERATION_IN_PROGRESS",
"SETUP_FUNCTION_UPGRADE_CONFIG_SUCCESSFUL",
"SETUP_FUNCTION_UPGRADE_CONFIG_ERROR",
"ABORT_FUNCTION_UPGRADE_ERROR",
"REDIRECT_FUNCTION_UPGRADE_TRAFFIC_SUCCESSFUL",
"REDIRECT_FUNCTION_UPGRADE_TRAFFIC_ERROR",
"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC_ERROR",
"COMMIT_FUNCTION_UPGRADE_ERROR"
],
"enumDescriptions": [
"Unspecified state. Most functions are in this upgrade state.",
"Functions in this state are eligible for 1st Gen -> 2nd Gen upgrade.",
"An upgrade related operation is in progress.",
"SetupFunctionUpgradeConfig API was successful and a 2nd Gen function has been created based on 1st Gen function instance.",
"SetupFunctionUpgradeConfig API was un-successful.",
"AbortFunctionUpgrade API was un-successful.",
"RedirectFunctionUpgradeTraffic API was successful and traffic is served by 2nd Gen function stack.",
"RedirectFunctionUpgradeTraffic API was un-successful.",
"RollbackFunctionUpgradeTraffic API was un-successful.",
"CommitFunctionUpgrade API was un-successful."
],
"type": "string"
}
},
"type": "object"
}
},
"servicePath": "",