From cced60843bdb9c979c6749ef0751e1e11543afe6 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:55 +0000 Subject: [PATCH 01/29] feat(accesscontextmanager): update the api #### accesscontextmanager:v1 The following keys were added: - resources.permissions.methods.list (Total Keys: 12) - schemas.ListSupportedPermissionsResponse (Total Keys: 5) --- docs/dyn/accesscontextmanager_v1.html | 5 + .../accesscontextmanager_v1.permissions.html | 129 ++++++++++++++++++ .../documents/accesscontextmanager.v1.json | 51 ++++++- 3 files changed, 184 insertions(+), 1 deletion(-) create mode 100644 docs/dyn/accesscontextmanager_v1.permissions.html diff --git a/docs/dyn/accesscontextmanager_v1.html b/docs/dyn/accesscontextmanager_v1.html index 2ea61aa26d1..839e9d6707b 100644 --- a/docs/dyn/accesscontextmanager_v1.html +++ b/docs/dyn/accesscontextmanager_v1.html @@ -89,6 +89,11 @@

Instance Methods

Returns the organizations Resource.

+

+ permissions() +

+

Returns the permissions Resource.

+

services()

diff --git a/docs/dyn/accesscontextmanager_v1.permissions.html b/docs/dyn/accesscontextmanager_v1.permissions.html new file mode 100644 index 00000000000..9a5f20eaf0f --- /dev/null +++ b/docs/dyn/accesscontextmanager_v1.permissions.html @@ -0,0 +1,129 @@ + + + +

Access Context Manager API . permissions

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ list(pageSize=None, pageToken=None, x__xgafv=None)

+

Lists all supported permissions in VPCSC Granular Controls.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ list(pageSize=None, pageToken=None, x__xgafv=None) +
Lists all supported permissions in VPCSC Granular Controls.
+
+Args:
+  pageSize: integer, Optional. This flag specifies the maximum number of services to return per page. Default is 100.
+  pageToken: string, Optional. Token to start on a later page. Default is the first page.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A response to `ListSupportedPermissionsRequest`.
+  "nextPageToken": "A String", # The pagination token to retrieve the next page of results. If the value is empty, no further results remain.
+  "supportedPermissions": [ # List of VPC-SC supported permissions.
+    "A String",
+  ],
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ + \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json b/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json index 5a02db01c04..8afef4ab5aa 100644 --- a/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json +++ b/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json @@ -1244,6 +1244,37 @@ } } }, +"permissions": { +"methods": { +"list": { +"description": "Lists all supported permissions in VPCSC Granular Controls.", +"flatPath": "v1/permissions", +"httpMethod": "GET", +"id": "accesscontextmanager.permissions.list", +"parameterOrder": [], +"parameters": { +"pageSize": { +"description": "Optional. This flag specifies the maximum number of services to return per page. Default is 100.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. Token to start on a later page. Default is the first page.", +"location": "query", +"type": "string" +} +}, +"path": "v1/permissions", +"response": { +"$ref": "ListSupportedPermissionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +}, "services": { "methods": { "get": { @@ -1300,7 +1331,7 @@ } } }, -"revision": "20251112", +"revision": "20260215", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -2189,6 +2220,24 @@ }, "type": "object" }, +"ListSupportedPermissionsResponse": { +"description": "A response to `ListSupportedPermissionsRequest`.", +"id": "ListSupportedPermissionsResponse", +"properties": { +"nextPageToken": { +"description": "The pagination token to retrieve the next page of results. If the value is empty, no further results remain.", +"type": "string" +}, +"supportedPermissions": { +"description": "List of VPC-SC supported permissions.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "ListSupportedServicesResponse": { "description": "A response to `ListSupportedServicesRequest`.", "id": "ListSupportedServicesResponse", From fdb0aa9884bbca77106e72819fec6cd7e5631f9f Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:55 +0000 Subject: [PATCH 02/29] feat(apigee): update the api #### apigee:v1 The following keys were added: - resources.organizations.resources.securityMonitoringConditions.methods.delete.parameters.riskAssessmentType (Total Keys: 2) - resources.organizations.resources.securityMonitoringConditions.methods.get.parameters.riskAssessmentType (Total Keys: 2) - resources.organizations.resources.securityMonitoringConditions.methods.list.parameters.riskAssessmentType (Total Keys: 2) - schemas.GoogleCloudApigeeV1SecurityAssessmentResultResource.properties.apiHubGatewayType.type (Total Keys: 1) - schemas.GoogleCloudApigeeV1SecurityMonitoringCondition.properties.apiHubGateway.type (Total Keys: 1) - schemas.GoogleCloudApigeeV1SecurityMonitoringCondition.properties.riskAssessmentType.type (Total Keys: 1) --- ...ganizations.securityAssessmentResults.html | 1 + ...izations.securityMonitoringConditions.html | 53 ++++++++--- .../discovery_cache/documents/apigee.v1.json | 87 ++++++++++++++++++- 3 files changed, 125 insertions(+), 16 deletions(-) diff --git a/docs/dyn/apigee_v1.organizations.securityAssessmentResults.html b/docs/dyn/apigee_v1.organizations.securityAssessmentResults.html index c2c750f0c0b..1f6e058df61 100644 --- a/docs/dyn/apigee_v1.organizations.securityAssessmentResults.html +++ b/docs/dyn/apigee_v1.organizations.securityAssessmentResults.html @@ -151,6 +151,7 @@

Method Details

"resourceUri": "A String", # The resource uri for the API Hub deployment. "sourceProject": "A String", # The source project for the API Hub deployment. }, + "apiHubGatewayType": "A String", # Optional. "name": "A String", # Required. Name of this resource. For an Apigee API Proxy, this should be the id of the API proxy. For an API Hub Deployment, this should be the id of the deployment. "resourceRevisionId": "A String", # The revision id for the resource. In case of Apigee, this is proxy revision id. "type": "A String", # Required. Type of this resource. diff --git a/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html b/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html index 220295daea9..642bccc27e4 100644 --- a/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html +++ b/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html @@ -81,13 +81,13 @@

Instance Methods

create(parent, body=None, securityMonitoringConditionId=None, x__xgafv=None)

Create a security monitoring condition.

- delete(name, x__xgafv=None)

+ delete(name, riskAssessmentType=None, x__xgafv=None)

Delete a security monitoring condition.

- get(name, x__xgafv=None)

+ get(name, riskAssessmentType=None, x__xgafv=None)

Get a security monitoring condition.

- list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

+ list(parent, filter=None, pageSize=None, pageToken=None, riskAssessmentType=None, x__xgafv=None)

List security monitoring conditions.

list_next()

@@ -111,6 +111,7 @@

Method Details

The object takes the form of: { # Security monitoring condition for risk assessment version 2. + "apiHubGateway": "A String", # Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}` "createTime": "A String", # Output only. The time of the security monitoring condition creation. "include": { # Message for the array of resources. For Apigee, the proxies are resources. # Include only these resources. "resources": [ # Required. The array of resources. For Apigee, the proxies are resources. @@ -124,7 +125,8 @@

Method Details

}, "name": "A String", # Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition} "profile": "A String", # Required. ID of security profile of the security monitoring condition. - "scope": "A String", # Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources. + "riskAssessmentType": "A String", # Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY. + "scope": "A String", # Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set. "totalDeployedResources": 42, # Output only. Total number of deployed resources within scope. "totalMonitoredResources": 42, # Output only. Total number of monitored resources within this condition. "updateTime": "A String", # Output only. The time of the security monitoring condition update. @@ -140,6 +142,7 @@

Method Details

An object of the form: { # Security monitoring condition for risk assessment version 2. + "apiHubGateway": "A String", # Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}` "createTime": "A String", # Output only. The time of the security monitoring condition creation. "include": { # Message for the array of resources. For Apigee, the proxies are resources. # Include only these resources. "resources": [ # Required. The array of resources. For Apigee, the proxies are resources. @@ -153,7 +156,8 @@

Method Details

}, "name": "A String", # Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition} "profile": "A String", # Required. ID of security profile of the security monitoring condition. - "scope": "A String", # Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources. + "riskAssessmentType": "A String", # Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY. + "scope": "A String", # Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set. "totalDeployedResources": 42, # Output only. Total number of deployed resources within scope. "totalMonitoredResources": 42, # Output only. Total number of monitored resources within this condition. "updateTime": "A String", # Output only. The time of the security monitoring condition update. @@ -161,11 +165,16 @@

Method Details

- delete(name, x__xgafv=None) + delete(name, riskAssessmentType=None, x__xgafv=None)
Delete a security monitoring condition.
 
 Args:
   name: string, Required. The name of the security monitoring condition to delete. Format: `organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}` (required)
+  riskAssessmentType: string, Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.
+    Allowed values
+      RISK_ASSESSMENT_TYPE_UNSPECIFIED - Risk assessment type is not specified.
+      APIGEE - Risk assessment type is Apigee.
+      API_HUB - Risk assessment type is API Hub.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -179,11 +188,16 @@ 

Method Details

- get(name, x__xgafv=None) + get(name, riskAssessmentType=None, x__xgafv=None)
Get a security monitoring condition.
 
 Args:
   name: string, Required. The name of the security monitoring condition to get. Format: `organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}` (required)
+  riskAssessmentType: string, Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.
+    Allowed values
+      RISK_ASSESSMENT_TYPE_UNSPECIFIED - Risk assessment type is not specified.
+      APIGEE - Risk assessment type is Apigee.
+      API_HUB - Risk assessment type is API Hub.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -193,6 +207,7 @@ 

Method Details

An object of the form: { # Security monitoring condition for risk assessment version 2. + "apiHubGateway": "A String", # Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}` "createTime": "A String", # Output only. The time of the security monitoring condition creation. "include": { # Message for the array of resources. For Apigee, the proxies are resources. # Include only these resources. "resources": [ # Required. The array of resources. For Apigee, the proxies are resources. @@ -206,7 +221,8 @@

Method Details

}, "name": "A String", # Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition} "profile": "A String", # Required. ID of security profile of the security monitoring condition. - "scope": "A String", # Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources. + "riskAssessmentType": "A String", # Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY. + "scope": "A String", # Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set. "totalDeployedResources": 42, # Output only. Total number of deployed resources within scope. "totalMonitoredResources": 42, # Output only. Total number of monitored resources within this condition. "updateTime": "A String", # Output only. The time of the security monitoring condition update. @@ -214,14 +230,19 @@

Method Details

- list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) + list(parent, filter=None, pageSize=None, pageToken=None, riskAssessmentType=None, x__xgafv=None)
List security monitoring conditions.
 
 Args:
   parent: string, Required. For a specific organization, list all the security monitoring conditions. Format: `organizations/{org}` (required)
-  filter: string, Optional. Filter for the monitoring conditions. For example: `profile=profile1 AND scope=env1`
+  filter: string, Optional. Filter for the monitoring conditions. When RiskAssessmentType is APIGEE, monitoring conditions can be filtered by profile and scope. For example: `profile=profile1 AND scope=env1` When RiskAssessmentType is API_HUB, monitoring conditions can be filtered by profile and api_hub_gateway. For example: `profile=profile1 AND api_hub_gateway=gateway1`
   pageSize: integer, Optional. The maximum number of monitoring conditions to return.
   pageToken: string, Optional. A page token, received from a previous `ListSecurityMonitoringConditions` call. Provide this to retrieve the subsequent page.
+  riskAssessmentType: string, Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.
+    Allowed values
+      RISK_ASSESSMENT_TYPE_UNSPECIFIED - Risk assessment type is not specified.
+      APIGEE - Risk assessment type is Apigee.
+      API_HUB - Risk assessment type is API Hub.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -234,6 +255,7 @@ 

Method Details

"nextPageToken": "A String", # A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. "securityMonitoringConditions": [ # List of security monitoring conditions in the organization. { # Security monitoring condition for risk assessment version 2. + "apiHubGateway": "A String", # Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}` "createTime": "A String", # Output only. The time of the security monitoring condition creation. "include": { # Message for the array of resources. For Apigee, the proxies are resources. # Include only these resources. "resources": [ # Required. The array of resources. For Apigee, the proxies are resources. @@ -247,7 +269,8 @@

Method Details

}, "name": "A String", # Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition} "profile": "A String", # Required. ID of security profile of the security monitoring condition. - "scope": "A String", # Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources. + "riskAssessmentType": "A String", # Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY. + "scope": "A String", # Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set. "totalDeployedResources": 42, # Output only. Total number of deployed resources within scope. "totalMonitoredResources": 42, # Output only. Total number of monitored resources within this condition. "updateTime": "A String", # Output only. The time of the security monitoring condition update. @@ -280,6 +303,7 @@

Method Details

The object takes the form of: { # Security monitoring condition for risk assessment version 2. + "apiHubGateway": "A String", # Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}` "createTime": "A String", # Output only. The time of the security monitoring condition creation. "include": { # Message for the array of resources. For Apigee, the proxies are resources. # Include only these resources. "resources": [ # Required. The array of resources. For Apigee, the proxies are resources. @@ -293,7 +317,8 @@

Method Details

}, "name": "A String", # Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition} "profile": "A String", # Required. ID of security profile of the security monitoring condition. - "scope": "A String", # Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources. + "riskAssessmentType": "A String", # Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY. + "scope": "A String", # Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set. "totalDeployedResources": 42, # Output only. Total number of deployed resources within scope. "totalMonitoredResources": 42, # Output only. Total number of monitored resources within this condition. "updateTime": "A String", # Output only. The time of the security monitoring condition update. @@ -309,6 +334,7 @@

Method Details

An object of the form: { # Security monitoring condition for risk assessment version 2. + "apiHubGateway": "A String", # Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}` "createTime": "A String", # Output only. The time of the security monitoring condition creation. "include": { # Message for the array of resources. For Apigee, the proxies are resources. # Include only these resources. "resources": [ # Required. The array of resources. For Apigee, the proxies are resources. @@ -322,7 +348,8 @@

Method Details

}, "name": "A String", # Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition} "profile": "A String", # Required. ID of security profile of the security monitoring condition. - "scope": "A String", # Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources. + "riskAssessmentType": "A String", # Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY. + "scope": "A String", # Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set. "totalDeployedResources": 42, # Output only. Total number of deployed resources within scope. "totalMonitoredResources": 42, # Output only. Total number of monitored resources within this condition. "updateTime": "A String", # Output only. The time of the security monitoring condition update. diff --git a/googleapiclient/discovery_cache/documents/apigee.v1.json b/googleapiclient/discovery_cache/documents/apigee.v1.json index 5b6b3e64480..db52eec2598 100644 --- a/googleapiclient/discovery_cache/documents/apigee.v1.json +++ b/googleapiclient/discovery_cache/documents/apigee.v1.json @@ -10384,6 +10384,21 @@ "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", "required": true, "type": "string" +}, +"riskAssessmentType": { +"description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", +"enum": [ +"RISK_ASSESSMENT_TYPE_UNSPECIFIED", +"APIGEE", +"API_HUB" +], +"enumDescriptions": [ +"Risk assessment type is not specified.", +"Risk assessment type is Apigee.", +"Risk assessment type is API Hub." +], +"location": "query", +"type": "string" } }, "path": "v1/{+name}", @@ -10409,6 +10424,21 @@ "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", "required": true, "type": "string" +}, +"riskAssessmentType": { +"description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", +"enum": [ +"RISK_ASSESSMENT_TYPE_UNSPECIFIED", +"APIGEE", +"API_HUB" +], +"enumDescriptions": [ +"Risk assessment type is not specified.", +"Risk assessment type is Apigee.", +"Risk assessment type is API Hub." +], +"location": "query", +"type": "string" } }, "path": "v1/{+name}", @@ -10429,7 +10459,7 @@ ], "parameters": { "filter": { -"description": "Optional. Filter for the monitoring conditions. For example: `profile=profile1 AND scope=env1`", +"description": "Optional. Filter for the monitoring conditions. When RiskAssessmentType is APIGEE, monitoring conditions can be filtered by profile and scope. For example: `profile=profile1 AND scope=env1` When RiskAssessmentType is API_HUB, monitoring conditions can be filtered by profile and api_hub_gateway. For example: `profile=profile1 AND api_hub_gateway=gateway1`", "location": "query", "type": "string" }, @@ -10450,6 +10480,21 @@ "pattern": "^organizations/[^/]+$", "required": true, "type": "string" +}, +"riskAssessmentType": { +"description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", +"enum": [ +"RISK_ASSESSMENT_TYPE_UNSPECIFIED", +"APIGEE", +"API_HUB" +], +"enumDescriptions": [ +"Risk assessment type is not specified.", +"Risk assessment type is Apigee.", +"Risk assessment type is API Hub." +], +"location": "query", +"type": "string" } }, "path": "v1/{+parent}/securityMonitoringConditions", @@ -11914,7 +11959,7 @@ } } }, -"revision": "20260130", +"revision": "20260218", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "ApiservingMcpMcpToolDataHandlingProfile": { @@ -19716,6 +19761,24 @@ "description": "Output only. Additional details for the API Hub deployment.", "readOnly": true }, +"apiHubGatewayType": { +"description": "Optional. ", +"enum": [ +"API_HUB_GATEWAY_TYPE_UNSPECIFIED", +"APIGEE_X", +"APIGEE_HYBRID", +"APIGEE_EDGE", +"APIGEE_OPDK" +], +"enumDescriptions": [ +"Gateway type is not specified.", +"Gateway is Apigee X for API Hub.", +"Gateway is Apigee Hybrid for API Hub.", +"Gateway is Apigee Edge for API Hub.", +"Gateway is Apigee OPDK for API Hub." +], +"type": "string" +}, "name": { "description": "Required. Name of this resource. For an Apigee API Proxy, this should be the id of the API proxy. For an API Hub Deployment, this should be the id of the deployment.", "type": "string" @@ -20096,6 +20159,10 @@ "description": "Security monitoring condition for risk assessment version 2.", "id": "GoogleCloudApigeeV1SecurityMonitoringCondition", "properties": { +"apiHubGateway": { +"description": "Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`", +"type": "string" +}, "createTime": { "description": "Output only. The time of the security monitoring condition creation.", "format": "google-datetime", @@ -20118,8 +20185,22 @@ "description": "Required. ID of security profile of the security monitoring condition.", "type": "string" }, +"riskAssessmentType": { +"description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", +"enum": [ +"RISK_ASSESSMENT_TYPE_UNSPECIFIED", +"APIGEE", +"API_HUB" +], +"enumDescriptions": [ +"Risk assessment type is not specified.", +"Risk assessment type is Apigee.", +"Risk assessment type is API Hub." +], +"type": "string" +}, "scope": { -"description": "Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources.", +"description": "Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set.", "type": "string" }, "totalDeployedResources": { From f878562ac70d5bdd95ddf499ce2d781308cf97f0 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:55 +0000 Subject: [PATCH 03/29] feat(appengine): update the api #### appengine:v1beta The following keys were deleted: - schemas.SubnetworkKey (Total Keys: 4) - schemas.Version.properties.vpcEgress (Total Keys: 2) - schemas.VpcEgress (Total Keys: 7) - schemas.VpcNetworkTag (Total Keys: 3) --- ...pengine_v1beta.apps.services.versions.html | 48 -------------- ...ations.applications.services.versions.html | 12 ---- .../documents/appengine.v1beta.json | 66 +------------------ 3 files changed, 1 insertion(+), 125 deletions(-) diff --git a/docs/dyn/appengine_v1beta.apps.services.versions.html b/docs/dyn/appengine_v1beta.apps.services.versions.html index e45c4b630ba..79036421cf3 100644 --- a/docs/dyn/appengine_v1beta.apps.services.versions.html +++ b/docs/dyn/appengine_v1beta.apps.services.versions.html @@ -354,18 +354,6 @@

Method Details

"egressSetting": "A String", # The egress setting for the connector, controlling what traffic is diverted through it. "name": "A String", # Full Serverless VPC Access Connector name e.g. projects/my-project/locations/us-central1/connectors/c1. }, - "vpcEgress": { # Deprecated: Use VpcAccess instead. Vpc Egress configuration. # Deprecated: Use vpc_access instead. Enables VPC egress connectivity for standard apps. - "egressSetting": "A String", # The egress setting for the subnetwork, controlling what traffic is diverted through it. - "networkTags": [ # The network tags to apply to the instance. - { # Network tag message. - "value": "A String", # value for the tag name - }, - ], - "subnetworkKey": { # Subnetwork key message. # The subnetwork key. - "hostProjectId": "A String", # Project id (name not number) of the project that hosts the network - "subnet": "A String", # Short name of the subnetwork. e.g. SUBNET instead of projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET} - }, - }, "zones": [ # The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated. "A String", ], @@ -700,18 +688,6 @@

Method Details

"egressSetting": "A String", # The egress setting for the connector, controlling what traffic is diverted through it. "name": "A String", # Full Serverless VPC Access Connector name e.g. projects/my-project/locations/us-central1/connectors/c1. }, - "vpcEgress": { # Deprecated: Use VpcAccess instead. Vpc Egress configuration. # Deprecated: Use vpc_access instead. Enables VPC egress connectivity for standard apps. - "egressSetting": "A String", # The egress setting for the subnetwork, controlling what traffic is diverted through it. - "networkTags": [ # The network tags to apply to the instance. - { # Network tag message. - "value": "A String", # value for the tag name - }, - ], - "subnetworkKey": { # Subnetwork key message. # The subnetwork key. - "hostProjectId": "A String", # Project id (name not number) of the project that hosts the network - "subnet": "A String", # Short name of the subnetwork. e.g. SUBNET instead of projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET} - }, - }, "zones": [ # The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated. "A String", ], @@ -980,18 +956,6 @@

Method Details

"egressSetting": "A String", # The egress setting for the connector, controlling what traffic is diverted through it. "name": "A String", # Full Serverless VPC Access Connector name e.g. projects/my-project/locations/us-central1/connectors/c1. }, - "vpcEgress": { # Deprecated: Use VpcAccess instead. Vpc Egress configuration. # Deprecated: Use vpc_access instead. Enables VPC egress connectivity for standard apps. - "egressSetting": "A String", # The egress setting for the subnetwork, controlling what traffic is diverted through it. - "networkTags": [ # The network tags to apply to the instance. - { # Network tag message. - "value": "A String", # value for the tag name - }, - ], - "subnetworkKey": { # Subnetwork key message. # The subnetwork key. - "hostProjectId": "A String", # Project id (name not number) of the project that hosts the network - "subnet": "A String", # Short name of the subnetwork. e.g. SUBNET instead of projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET} - }, - }, "zones": [ # The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated. "A String", ], @@ -1263,18 +1227,6 @@

Method Details

"egressSetting": "A String", # The egress setting for the connector, controlling what traffic is diverted through it. "name": "A String", # Full Serverless VPC Access Connector name e.g. projects/my-project/locations/us-central1/connectors/c1. }, - "vpcEgress": { # Deprecated: Use VpcAccess instead. Vpc Egress configuration. # Deprecated: Use vpc_access instead. Enables VPC egress connectivity for standard apps. - "egressSetting": "A String", # The egress setting for the subnetwork, controlling what traffic is diverted through it. - "networkTags": [ # The network tags to apply to the instance. - { # Network tag message. - "value": "A String", # value for the tag name - }, - ], - "subnetworkKey": { # Subnetwork key message. # The subnetwork key. - "hostProjectId": "A String", # Project id (name not number) of the project that hosts the network - "subnet": "A String", # Short name of the subnetwork. e.g. SUBNET instead of projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET} - }, - }, "zones": [ # The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated. "A String", ], diff --git a/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html b/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html index 987234bb74c..7b9f692fe1c 100644 --- a/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html +++ b/docs/dyn/appengine_v1beta.projects.locations.applications.services.versions.html @@ -384,18 +384,6 @@

Method Details

"egressSetting": "A String", # The egress setting for the connector, controlling what traffic is diverted through it. "name": "A String", # Full Serverless VPC Access Connector name e.g. projects/my-project/locations/us-central1/connectors/c1. }, - "vpcEgress": { # Deprecated: Use VpcAccess instead. Vpc Egress configuration. # Deprecated: Use vpc_access instead. Enables VPC egress connectivity for standard apps. - "egressSetting": "A String", # The egress setting for the subnetwork, controlling what traffic is diverted through it. - "networkTags": [ # The network tags to apply to the instance. - { # Network tag message. - "value": "A String", # value for the tag name - }, - ], - "subnetworkKey": { # Subnetwork key message. # The subnetwork key. - "hostProjectId": "A String", # Project id (name not number) of the project that hosts the network - "subnet": "A String", # Short name of the subnetwork. e.g. SUBNET instead of projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET} - }, - }, "zones": [ # The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated. "A String", ], diff --git a/googleapiclient/discovery_cache/documents/appengine.v1beta.json b/googleapiclient/discovery_cache/documents/appengine.v1beta.json index 3f52ef0b4ac..8ef9ead2ac4 100644 --- a/googleapiclient/discovery_cache/documents/appengine.v1beta.json +++ b/googleapiclient/discovery_cache/documents/appengine.v1beta.json @@ -2868,7 +2868,7 @@ } } }, -"revision": "20260202", +"revision": "20260220", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -5120,21 +5120,6 @@ true }, "type": "object" }, -"SubnetworkKey": { -"description": "Subnetwork key message.", -"id": "SubnetworkKey", -"properties": { -"hostProjectId": { -"description": "Project id (name not number) of the project that hosts the network", -"type": "string" -}, -"subnet": { -"description": "Short name of the subnetwork. e.g. SUBNET instead of projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET}", -"type": "string" -} -}, -"type": "object" -}, "TrafficSplit": { "description": "Traffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions.", "id": "TrafficSplit", @@ -5554,11 +5539,6 @@ true "$ref": "VpcAccessConnector", "description": "Enables VPC connectivity for standard apps." }, -"vpcEgress": { -"$ref": "VpcEgress", -"deprecated": true, -"description": "Deprecated: Use vpc_access instead. Enables VPC egress connectivity for standard apps." -}, "zones": { "description": "The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.", "items": { @@ -5642,39 +5622,6 @@ true }, "type": "object" }, -"VpcEgress": { -"deprecated": true, -"description": "Deprecated: Use VpcAccess instead. Vpc Egress configuration.", -"id": "VpcEgress", -"properties": { -"egressSetting": { -"description": "The egress setting for the subnetwork, controlling what traffic is diverted through it.", -"enum": [ -"EGRESS_SETTING_UNSPECIFIED", -"ALL_TRAFFIC", -"PRIVATE_IP_RANGES" -], -"enumDescriptions": [ -"No value set; apply default behavior", -"Force all traffic to egress through the NetworkInterface (and configured VPC Network)", -"Force all Private IP Space traffic to egress through NetworkInterface (and configured VPC Network)" -], -"type": "string" -}, -"networkTags": { -"description": "The network tags to apply to the instance.", -"items": { -"$ref": "VpcNetworkTag" -}, -"type": "array" -}, -"subnetworkKey": { -"$ref": "SubnetworkKey", -"description": "The subnetwork key." -} -}, -"type": "object" -}, "VpcNetworkInterface": { "description": "Network interface key message.", "id": "VpcNetworkInterface", @@ -5697,17 +5644,6 @@ true }, "type": "object" }, -"VpcNetworkTag": { -"description": "Network tag message.", -"id": "VpcNetworkTag", -"properties": { -"value": { -"description": "value for the tag name", -"type": "string" -} -}, -"type": "object" -}, "ZipInfo": { "description": "The zip file information for a zip deployment.", "id": "ZipInfo", From e565fc7b0b626540aa388c673af0701ad3949307 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:55 +0000 Subject: [PATCH 04/29] feat(cloudkms): update the api #### cloudkms:v1 The following keys were added: - schemas.Digest.properties.externalMu (Total Keys: 2) The following keys were changed: - endpoints (Total Keys: 1) --- ...s.keyRings.cryptoKeys.cryptoKeyVersions.html | 1 + .../discovery_cache/documents/cloudkms.v1.json | 17 +++++++++++------ 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html index 651b184cc80..2fb9907ca8a 100644 --- a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html +++ b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.html @@ -172,6 +172,7 @@

Method Details

"data": "A String", # Optional. The data to sign. It can't be supplied if AsymmetricSignRequest.digest is supplied. "dataCrc32c": "A String", # Optional. An optional CRC32C checksum of the AsymmetricSignRequest.data. If specified, KeyManagementService will verify the integrity of the received AsymmetricSignRequest.data using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C(AsymmetricSignRequest.data) is equal to AsymmetricSignRequest.data_crc32c, and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type. "digest": { # A Digest holds a cryptographic message digest. # Optional. The digest of the data to sign. The digest must be produced with the same digest algorithm as specified by the key version's algorithm. This field may not be supplied if AsymmetricSignRequest.data is supplied. + "externalMu": "A String", # A message digest produced with SHAKE-256, to be used with ML-DSA external-μ algorithms only. See "message representative" note in section 6.2, algorithm 7 of the FIPS-204 standard: https://doi.org/10.6028/nist.fips.204 "sha256": "A String", # A message digest produced with the SHA-256 algorithm. "sha384": "A String", # A message digest produced with the SHA-384 algorithm. "sha512": "A String", # A message digest produced with the SHA-512 algorithm. diff --git a/googleapiclient/discovery_cache/documents/cloudkms.v1.json b/googleapiclient/discovery_cache/documents/cloudkms.v1.json index dfd7902a7bc..32ec5969df2 100644 --- a/googleapiclient/discovery_cache/documents/cloudkms.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudkms.v1.json @@ -61,11 +61,6 @@ }, { "description": "Regional Endpoint", -"endpointUrl": "https://cloudkms.us-east7.rep.googleapis.com/", -"location": "us-east7" -}, -{ -"description": "Regional Endpoint", "endpointUrl": "https://cloudkms.us-central1.rep.googleapis.com/", "location": "us-central1" }, @@ -101,6 +96,11 @@ }, { "description": "Regional Endpoint", +"endpointUrl": "https://cloudkms.us-east7.rep.googleapis.com/", +"location": "us-east7" +}, +{ +"description": "Regional Endpoint", "endpointUrl": "https://cloudkms.us.rep.googleapis.com/", "location": "us" }, @@ -2938,7 +2938,7 @@ } } }, -"revision": "20260206", +"revision": "20260213", "rootUrl": "https://cloudkms.googleapis.com/", "schemas": { "AddQuorumMember": { @@ -3952,6 +3952,11 @@ "description": "A Digest holds a cryptographic message digest.", "id": "Digest", "properties": { +"externalMu": { +"description": "A message digest produced with SHAKE-256, to be used with ML-DSA external-\u03bc algorithms only. See \"message representative\" note in section 6.2, algorithm 7 of the FIPS-204 standard: https://doi.org/10.6028/nist.fips.204", +"format": "byte", +"type": "string" +}, "sha256": { "description": "A message digest produced with the SHA-256 algorithm.", "format": "byte", From 8390b91e2904dae9b316b3db5a7474fcd33f6224 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:55 +0000 Subject: [PATCH 05/29] feat(compute): update the api #### compute:alpha The following keys were deleted: - schemas.AttachedDisk.properties.userLicenses (Total Keys: 3) - schemas.Disk.properties.userLicenses (Total Keys: 2) - schemas.Image.properties.userLicenses (Total Keys: 2) - schemas.RecoverableSnapshotOriginalSnapshot.properties.userLicenses (Total Keys: 2) - schemas.Snapshot.properties.userLicenses (Total Keys: 2) - schemas.VmExtensionState.properties.unhealthyMsg.type (Total Keys: 1) The following keys were added: - resources.reservationSubBlocks.methods.get.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.getVersion.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.list.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.performMaintenance.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.reportFaulty.parameters.parentName.pattern (Total Keys: 1) - schemas.VmExtensionState.properties.healthMsg.type (Total Keys: 1) The following keys were changed: - resources.reservationSubBlocks.methods.get (Total Keys: 2) - resources.reservationSubBlocks.methods.getVersion (Total Keys: 2) - resources.reservationSubBlocks.methods.list (Total Keys: 2) - resources.reservationSubBlocks.methods.performMaintenance (Total Keys: 2) - resources.reservationSubBlocks.methods.reportFaulty (Total Keys: 2) #### compute:beta The following keys were deleted: - schemas.AttachedDisk.properties.userLicenses (Total Keys: 3) - schemas.Disk.properties.userLicenses (Total Keys: 2) - schemas.Image.properties.userLicenses (Total Keys: 2) - schemas.Snapshot.properties.userLicenses (Total Keys: 2) The following keys were added: - resources.instanceGroupManagers.methods.configureAcceleratorTopologies (Total Keys: 20) - resources.reservationSubBlocks.methods.get.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.list.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.performMaintenance.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.reportFaulty.parameters.parentName.pattern (Total Keys: 1) - resources.routers.methods.deleteNamedSet (Total Keys: 23) - resources.routers.methods.getNamedSet (Total Keys: 20) - resources.routers.methods.listNamedSets (Total Keys: 32) - resources.routers.methods.patchNamedSet (Total Keys: 22) - resources.routers.methods.updateNamedSet (Total Keys: 22) - resources.snapshotGroups.methods.delete (Total Keys: 17) - resources.snapshotGroups.methods.get (Total Keys: 33) - resources.snapshotGroups.methods.insert (Total Keys: 14) - resources.snapshotGroups.methods.list (Total Keys: 24) - resources.snapshotGroups.methods.setIamPolicy (Total Keys: 16) - resources.snapshotGroups.methods.testIamPermissions (Total Keys: 16) - schemas.Backend.properties.orchestrationInfo.$ref (Total Keys: 1) - schemas.BackendBackendOrchestrationInfo (Total Keys: 3) - schemas.BackendService.properties.orchestrationInfo.$ref (Total Keys: 1) - schemas.BackendServiceOrchestrationInfo (Total Keys: 3) - schemas.BulkInsertDiskResource.properties.snapshotGroupParameters.$ref (Total Keys: 1) - schemas.InstanceGroupManagersConfigureAcceleratorTopologiesRequest (Total Keys: 4) - schemas.InstanceGroupManagersGetAvailableAcceleratorTopologiesResponse.properties.multiMig.type (Total Keys: 1) - schemas.InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyInfo.properties.acceleratorTopologyState.$ref (Total Keys: 1) - schemas.InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyInfo.properties.instancesHealth.type (Total Keys: 1) - schemas.InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyInfo.properties.parent.type (Total Keys: 1) - schemas.InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState (Total Keys: 17) - schemas.ListSnapshotGroups (Total Keys: 21) - schemas.LocationPolicy.properties.zones (Total Keys: 2) - schemas.LocationPolicyZoneConfiguration (Total Keys: 3) - schemas.NamedSet (Total Keys: 8) - schemas.Reservation.properties.params.$ref (Total Keys: 1) - schemas.ReservationParams (Total Keys: 4) - schemas.RoutersGetNamedSetResponse (Total Keys: 3) - schemas.RoutersListNamedSets (Total Keys: 21) - schemas.Snapshot.properties.snapshotGroupId (Total Keys: 2) - schemas.Snapshot.properties.snapshotGroupName (Total Keys: 2) - schemas.SnapshotGroup (Total Keys: 41) The following keys were changed: - resources.reservationSubBlocks.methods.get (Total Keys: 2) - resources.reservationSubBlocks.methods.getIamPolicy (Total Keys: 2) - resources.reservationSubBlocks.methods.list (Total Keys: 2) - resources.reservationSubBlocks.methods.performMaintenance (Total Keys: 2) - resources.reservationSubBlocks.methods.reportFaulty (Total Keys: 2) - resources.reservationSubBlocks.methods.setIamPolicy (Total Keys: 2) - resources.reservationSubBlocks.methods.testIamPermissions (Total Keys: 2) #### compute:v1 The following keys were added: - resources.regionHealthAggregationPolicies.methods.aggregatedList (Total Keys: 29) - resources.regionHealthAggregationPolicies.methods.delete (Total Keys: 21) - resources.regionHealthAggregationPolicies.methods.get (Total Keys: 19) - resources.regionHealthAggregationPolicies.methods.insert (Total Keys: 18) - resources.regionHealthAggregationPolicies.methods.list (Total Keys: 28) - resources.regionHealthAggregationPolicies.methods.patch (Total Keys: 21) - resources.regionHealthAggregationPolicies.methods.testIamPermissions (Total Keys: 20) - resources.reservationSubBlocks.methods.get.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.list.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.performMaintenance.parameters.parentName.pattern (Total Keys: 1) - resources.reservationSubBlocks.methods.reportFaulty.parameters.parentName.pattern (Total Keys: 1) - schemas.Backend.properties.orchestrationInfo.$ref (Total Keys: 1) - schemas.BackendBackendOrchestrationInfo (Total Keys: 3) - schemas.BackendService.properties.orchestrationInfo.$ref (Total Keys: 1) - schemas.BackendServiceOrchestrationInfo (Total Keys: 3) - schemas.ExternalVpnGateway.properties.params.$ref (Total Keys: 1) - schemas.ExternalVpnGatewayParams (Total Keys: 4) - schemas.HealthAggregationPoliciesScopedList (Total Keys: 11) - schemas.HealthAggregationPolicy (Total Keys: 63) - schemas.LocationPolicy.properties.zones (Total Keys: 2) - schemas.LocationPolicyZoneConfiguration (Total Keys: 3) - schemas.Reservation.properties.params.$ref (Total Keys: 1) - schemas.ReservationParams (Total Keys: 4) - schemas.ResourceStatusEffectiveInstanceMetadata.properties.gceContainerDeclarationMetadataValue.type (Total Keys: 1) - schemas.TargetVpnGateway.properties.params.$ref (Total Keys: 1) - schemas.TargetVpnGatewayParams (Total Keys: 4) - schemas.VpnGateway.properties.params.$ref (Total Keys: 1) - schemas.VpnGatewayParams (Total Keys: 4) - schemas.VpnTunnel.properties.params.$ref (Total Keys: 1) - schemas.VpnTunnelParams (Total Keys: 4) The following keys were changed: - resources.reservationSubBlocks.methods.get (Total Keys: 2) - resources.reservationSubBlocks.methods.getIamPolicy (Total Keys: 2) - resources.reservationSubBlocks.methods.list (Total Keys: 2) - resources.reservationSubBlocks.methods.performMaintenance (Total Keys: 2) - resources.reservationSubBlocks.methods.reportFaulty (Total Keys: 2) - resources.reservationSubBlocks.methods.setIamPolicy (Total Keys: 2) - resources.reservationSubBlocks.methods.testIamPermissions (Total Keys: 2) --- docs/dyn/compute_alpha.disks.html | 58 +- ...mpute_alpha.globalVmExtensionPolicies.html | 6 +- docs/dyn/compute_alpha.imageFamilyViews.html | 10 +- docs/dyn/compute_alpha.images.html | 50 +- .../compute_alpha.instanceGroupManagers.html | 110 +- docs/dyn/compute_alpha.instanceTemplates.html | 36 +- docs/dyn/compute_alpha.instances.html | 89 +- docs/dyn/compute_alpha.machineImages.html | 27 +- .../compute_alpha.recoverableSnapshots.html | 12 - docs/dyn/compute_alpha.regionDisks.html | 49 +- ...ute_alpha.regionInstanceGroupManagers.html | 94 +- ...compute_alpha.regionInstanceTemplates.html | 27 +- docs/dyn/compute_alpha.regionInstances.html | 31 +- ...pute_alpha.regionRecoverableSnapshots.html | 8 - docs/dyn/compute_alpha.regionSnapshots.html | 18 +- docs/dyn/compute_alpha.snapshots.html | 24 +- .../compute_alpha.zoneQueuedResources.html | 124 +- ...compute_alpha.zoneVmExtensionPolicies.html | 24 +- docs/dyn/compute_beta.backendServices.html | 63 + docs/dyn/compute_beta.disks.html | 78 +- ...ompute_beta.globalVmExtensionPolicies.html | 6 +- docs/dyn/compute_beta.html | 5 + docs/dyn/compute_beta.imageFamilyViews.html | 10 +- docs/dyn/compute_beta.images.html | 50 +- .../compute_beta.instanceGroupManagers.html | 463 +- docs/dyn/compute_beta.instanceTemplates.html | 36 +- docs/dyn/compute_beta.instances.html | 85 +- docs/dyn/compute_beta.machineImages.html | 27 +- .../compute_beta.regionBackendServices.html | 54 + docs/dyn/compute_beta.regionCommitments.html | 72 + docs/dyn/compute_beta.regionDisks.html | 69 +- ...pute_beta.regionInstanceGroupManagers.html | 52 +- .../compute_beta.regionInstanceTemplates.html | 27 +- docs/dyn/compute_beta.regionInstances.html | 33 +- docs/dyn/compute_beta.regionSnapshots.html | 27 +- docs/dyn/compute_beta.reservations.html | 60 + docs/dyn/compute_beta.routers.html | 5366 ++++++++++------- docs/dyn/compute_beta.snapshotGroups.html | 2218 +++++++ docs/dyn/compute_beta.snapshots.html | 36 +- .../compute_beta.zoneVmExtensionPolicies.html | 24 +- docs/dyn/compute_v1.backendServices.html | 63 + docs/dyn/compute_v1.disks.html | 14 +- docs/dyn/compute_v1.externalVpnGateways.html | 57 + docs/dyn/compute_v1.html | 5 + docs/dyn/compute_v1.imageFamilyViews.html | 2 +- docs/dyn/compute_v1.images.html | 10 +- docs/dyn/compute_v1.instanceTemplates.html | 16 +- docs/dyn/compute_v1.instances.html | 50 +- docs/dyn/compute_v1.machineImages.html | 12 +- .../dyn/compute_v1.regionBackendServices.html | 54 + docs/dyn/compute_v1.regionCommitments.html | 60 + docs/dyn/compute_v1.regionDisks.html | 13 +- ...te_v1.regionHealthAggregationPolicies.html | 1658 +++++ .../compute_v1.regionInstanceTemplates.html | 12 +- docs/dyn/compute_v1.regionInstances.html | 23 +- docs/dyn/compute_v1.reservations.html | 60 + docs/dyn/compute_v1.snapshots.html | 6 +- docs/dyn/compute_v1.targetVpnGateways.html | 76 + docs/dyn/compute_v1.vpnGateways.html | 76 + docs/dyn/compute_v1.vpnTunnels.html | 76 + .../documents/compute.alpha.json | 99 +- .../documents/compute.beta.json | 1665 ++++- .../discovery_cache/documents/compute.v1.json | 1720 ++++-- 63 files changed, 11777 insertions(+), 3708 deletions(-) create mode 100644 docs/dyn/compute_beta.snapshotGroups.html create mode 100644 docs/dyn/compute_v1.regionHealthAggregationPolicies.html diff --git a/docs/dyn/compute_alpha.disks.html b/docs/dyn/compute_alpha.disks.html index e421082b936..6bd0b18e96f 100644 --- a/docs/dyn/compute_alpha.disks.html +++ b/docs/dyn/compute_alpha.disks.html @@ -822,7 +822,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1173,14 +1173,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -2345,7 +2337,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2578,10 +2570,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } guestFlush: boolean, [Input Only] Whether to attempt an application consistent snapshot by @@ -3435,7 +3423,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3786,14 +3774,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -4505,7 +4485,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4856,14 +4836,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -5511,7 +5483,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5862,14 +5834,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -8690,7 +8654,7 @@

Method Details

update(project, zone, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)
Updates the specified disk with the data included in the request.
 The update is performed only on selected fields included as part
-of update-mask. Only the following fields can be modified: user_license.
+of update-mask.
 
 Args:
   project: string, Project ID for this request. (required)
@@ -8948,7 +8912,7 @@ 

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9299,14 +9263,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", diff --git a/docs/dyn/compute_alpha.globalVmExtensionPolicies.html b/docs/dyn/compute_alpha.globalVmExtensionPolicies.html index 030a0827c11..ac80c01a400 100644 --- a/docs/dyn/compute_alpha.globalVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.globalVmExtensionPolicies.html @@ -231,8 +231,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -278,7 +278,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. diff --git a/docs/dyn/compute_alpha.imageFamilyViews.html b/docs/dyn/compute_alpha.imageFamilyViews.html index fe649d4998d..7721935a8ab 100644 --- a/docs/dyn/compute_alpha.imageFamilyViews.html +++ b/docs/dyn/compute_alpha.imageFamilyViews.html @@ -323,7 +323,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -637,14 +637,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], }, }
diff --git a/docs/dyn/compute_alpha.images.html b/docs/dyn/compute_alpha.images.html index 1e8a9ceced2..bdc197dbde0 100644 --- a/docs/dyn/compute_alpha.images.html +++ b/docs/dyn/compute_alpha.images.html @@ -986,7 +986,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1300,14 +1300,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } @@ -1547,7 +1539,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1861,14 +1853,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } @@ -2468,7 +2452,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2782,14 +2766,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } forceCreate: boolean, Force image creation if true. @@ -3404,7 +3380,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3718,14 +3694,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], }, ], "kind": "compute#imageList", # Output only. Type of resource. @@ -4007,7 +3975,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4321,14 +4289,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so diff --git a/docs/dyn/compute_alpha.instanceGroupManagers.html b/docs/dyn/compute_alpha.instanceGroupManagers.html index 35f7fd43112..93fb5212b32 100644 --- a/docs/dyn/compute_alpha.instanceGroupManagers.html +++ b/docs/dyn/compute_alpha.instanceGroupManagers.html @@ -1034,7 +1034,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1284,11 +1284,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -1538,7 +1533,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1788,11 +1783,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -1895,7 +1885,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -4921,7 +4911,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5171,11 +5161,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -5425,7 +5410,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5675,11 +5660,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -5782,7 +5762,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -6923,7 +6903,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7173,11 +7153,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -7427,7 +7402,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7677,11 +7652,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -7784,7 +7754,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -9157,7 +9127,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9407,11 +9377,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -9661,7 +9626,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9911,11 +9876,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -10018,7 +9978,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -11185,7 +11145,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -11435,11 +11395,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineType": "A String", # The machine type to be used for this instance. @@ -11900,7 +11855,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -12150,11 +12105,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineType": "A String", # Output only. The machine type to be used for this instance. @@ -12877,7 +12827,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -13127,11 +13077,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -13381,7 +13326,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -13631,11 +13576,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -13738,7 +13678,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -18701,7 +18641,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -18951,11 +18891,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -19205,7 +19140,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -19455,11 +19390,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -19562,7 +19492,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and diff --git a/docs/dyn/compute_alpha.instanceTemplates.html b/docs/dyn/compute_alpha.instanceTemplates.html index 21b07b1c5c1..aeb0fe63253 100644 --- a/docs/dyn/compute_alpha.instanceTemplates.html +++ b/docs/dyn/compute_alpha.instanceTemplates.html @@ -531,7 +531,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -781,11 +781,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1097,7 +1092,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -2074,7 +2069,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2324,11 +2319,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -2640,7 +2630,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -3602,7 +3592,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3852,11 +3842,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -4168,7 +4153,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -5140,7 +5125,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5390,11 +5375,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -5706,7 +5686,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_alpha.instances.html b/docs/dyn/compute_alpha.instances.html index 421fd8ee4d5..0d940aef1f3 100644 --- a/docs/dyn/compute_alpha.instances.html +++ b/docs/dyn/compute_alpha.instances.html @@ -1819,7 +1819,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2069,11 +2069,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -2485,7 +2480,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3334,7 +3329,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3584,11 +3579,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], } forceAttach: boolean, Whether to force attach the regional disk even if it's currently attached @@ -4145,7 +4135,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4395,11 +4385,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -4692,7 +4677,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4942,11 +4927,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -5258,7 +5238,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -5489,6 +5469,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -5504,11 +5491,13 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. - "zones": [ # List with zones where bulk will create instances. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. { - "zone": "A String", # The URL of thezone. + "zone": "A String", # The URL of the zone. # The zone must exist in the region where the request is called. - # Zones must be represented as valid internal URLs, + # Zones must be represented as valid partial URLs, # such as zones/us-central1-a. }, ], @@ -7333,7 +7322,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7583,11 +7572,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -7999,7 +7983,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -10223,11 +10207,10 @@

Method Details

"enforcementState": "A String", # The enforcement state of the extension. # If the extension is not enforced yet, then the health status will not be # specified. + "healthMsg": "A String", # The health status message of the extension. "healthStatus": "A String", # The health status of the extension. "name": "A String", # The name of the extension. "policyId": "A String", # The id of the policy that is enforced on the extension. - "unhealthyMsg": "A String", # The status message of the extension if the extension is in unhealthy - # state. "version": "A String", # The version of the extension. } @@ -10521,7 +10504,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -10771,11 +10754,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -11187,7 +11165,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -12400,7 +12378,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -12650,11 +12628,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -13066,7 +13039,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -13909,11 +13882,10 @@

Method Details

"enforcementState": "A String", # The enforcement state of the extension. # If the extension is not enforced yet, then the health status will not be # specified. + "healthMsg": "A String", # The health status message of the extension. "healthStatus": "A String", # The health status of the extension. "name": "A String", # The name of the extension. "policyId": "A String", # The id of the policy that is enforced on the extension. - "unhealthyMsg": "A String", # The status message of the extension if the extension is in unhealthy - # state. "version": "A String", # The version of the extension. }, ], @@ -23215,7 +23187,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -23465,11 +23437,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -23881,7 +23848,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced diff --git a/docs/dyn/compute_alpha.machineImages.html b/docs/dyn/compute_alpha.machineImages.html index b0bfc72f834..fcfee24fc31 100644 --- a/docs/dyn/compute_alpha.machineImages.html +++ b/docs/dyn/compute_alpha.machineImages.html @@ -709,7 +709,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -959,11 +959,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1275,7 +1270,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -2951,7 +2946,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3201,11 +3196,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -3517,7 +3507,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -5199,7 +5189,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5449,11 +5439,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -5765,7 +5750,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_alpha.recoverableSnapshots.html b/docs/dyn/compute_alpha.recoverableSnapshots.html index 9c2dab4449c..8dc56d28d36 100644 --- a/docs/dyn/compute_alpha.recoverableSnapshots.html +++ b/docs/dyn/compute_alpha.recoverableSnapshots.html @@ -527,10 +527,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, "purgeTimestamp": "A String", # Output only. [Output Only] Purge timestamp of recoverable snapshot inRFC3339 # text format. @@ -1243,10 +1239,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, "purgeTimestamp": "A String", # Output only. [Output Only] Purge timestamp of recoverable snapshot inRFC3339 # text format. @@ -2032,10 +2024,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, "purgeTimestamp": "A String", # Output only. [Output Only] Purge timestamp of recoverable snapshot inRFC3339 # text format. diff --git a/docs/dyn/compute_alpha.regionDisks.html b/docs/dyn/compute_alpha.regionDisks.html index b791ac85a4b..6dbd740b715 100644 --- a/docs/dyn/compute_alpha.regionDisks.html +++ b/docs/dyn/compute_alpha.regionDisks.html @@ -898,7 +898,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1131,10 +1131,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } guestFlush: boolean, [Input Only] Specifies to create an application consistent snapshot by @@ -1988,7 +1984,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2339,14 +2335,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -3055,7 +3043,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3406,14 +3394,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -4061,7 +4041,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4412,14 +4392,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -7237,8 +7209,7 @@

Method Details

update(project, region, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)
Update the specified disk with the data included in the request. Update is
-performed only on selected fields included as part of update-mask. Only the
-following fields can be modified: user_license.
+performed only on selected fields included as part of update-mask.
 
 Args:
   project: string, Project ID for this request. (required)
@@ -7496,7 +7467,7 @@ 

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7847,14 +7818,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", diff --git a/docs/dyn/compute_alpha.regionInstanceGroupManagers.html b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html index b252820d81a..044a19303c8 100644 --- a/docs/dyn/compute_alpha.regionInstanceGroupManagers.html +++ b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html @@ -2922,7 +2922,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3172,11 +3172,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -3426,7 +3421,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3676,11 +3671,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -3783,7 +3773,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -4786,7 +4776,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5036,11 +5026,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -5290,7 +5275,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5540,11 +5525,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -5647,7 +5627,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -7019,7 +6999,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7269,11 +7249,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -7523,7 +7498,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7773,11 +7748,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -7880,7 +7850,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -9042,7 +9012,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9292,11 +9262,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineType": "A String", # The machine type to be used for this instance. @@ -9757,7 +9722,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -10007,11 +9972,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineType": "A String", # Output only. The machine type to be used for this instance. @@ -10731,7 +10691,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -10981,11 +10941,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -11235,7 +11190,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -11485,11 +11440,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -11592,7 +11542,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -16521,7 +16471,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -16771,11 +16721,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -17025,7 +16970,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -17275,11 +17220,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -17382,7 +17322,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and diff --git a/docs/dyn/compute_alpha.regionInstanceTemplates.html b/docs/dyn/compute_alpha.regionInstanceTemplates.html index 00f58febb0f..6659d635a26 100644 --- a/docs/dyn/compute_alpha.regionInstanceTemplates.html +++ b/docs/dyn/compute_alpha.regionInstanceTemplates.html @@ -721,7 +721,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -971,11 +971,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1287,7 +1282,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1879,7 +1874,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2129,11 +2124,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -2445,7 +2435,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -3418,7 +3408,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3668,11 +3658,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -3984,7 +3969,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_alpha.regionInstances.html b/docs/dyn/compute_alpha.regionInstances.html index 9f9efe2c5fd..4f30e57285e 100644 --- a/docs/dyn/compute_alpha.regionInstances.html +++ b/docs/dyn/compute_alpha.regionInstances.html @@ -345,7 +345,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -595,11 +595,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -892,7 +887,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1142,11 +1137,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1458,7 +1448,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1689,6 +1679,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -1704,11 +1701,13 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. - "zones": [ # List with zones where bulk will create instances. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. { - "zone": "A String", # The URL of thezone. + "zone": "A String", # The URL of the zone. # The zone must exist in the region where the request is called. - # Zones must be represented as valid internal URLs, + # Zones must be represented as valid partial URLs, # such as zones/us-central1-a. }, ], diff --git a/docs/dyn/compute_alpha.regionRecoverableSnapshots.html b/docs/dyn/compute_alpha.regionRecoverableSnapshots.html index b4a8d3fb0ea..215e0c4ed11 100644 --- a/docs/dyn/compute_alpha.regionRecoverableSnapshots.html +++ b/docs/dyn/compute_alpha.regionRecoverableSnapshots.html @@ -723,10 +723,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, "purgeTimestamp": "A String", # Output only. [Output Only] Purge timestamp of recoverable snapshot inRFC3339 # text format. @@ -1515,10 +1511,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, "purgeTimestamp": "A String", # Output only. [Output Only] Purge timestamp of recoverable snapshot inRFC3339 # text format. diff --git a/docs/dyn/compute_alpha.regionSnapshots.html b/docs/dyn/compute_alpha.regionSnapshots.html index e638d8ec378..b79a8a28c4f 100644 --- a/docs/dyn/compute_alpha.regionSnapshots.html +++ b/docs/dyn/compute_alpha.regionSnapshots.html @@ -523,7 +523,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -756,10 +756,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }
@@ -1236,7 +1232,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1469,10 +1465,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so @@ -1956,7 +1948,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2189,10 +2181,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, ], "kind": "compute#snapshotList", # Output only. Type of resource. diff --git a/docs/dyn/compute_alpha.snapshots.html b/docs/dyn/compute_alpha.snapshots.html index ad53be0a4f5..79699a59f58 100644 --- a/docs/dyn/compute_alpha.snapshots.html +++ b/docs/dyn/compute_alpha.snapshots.html @@ -326,7 +326,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -559,10 +559,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, ], "warning": { # [Output Only] Informational warning which replaces the list of snapshots @@ -1059,7 +1055,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1292,10 +1288,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } @@ -1795,7 +1787,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2028,10 +2020,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so @@ -2514,7 +2502,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2747,10 +2735,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, ], "kind": "compute#snapshotList", # Output only. Type of resource. diff --git a/docs/dyn/compute_alpha.zoneQueuedResources.html b/docs/dyn/compute_alpha.zoneQueuedResources.html index b8a12c30b1a..66766417526 100644 --- a/docs/dyn/compute_alpha.zoneQueuedResources.html +++ b/docs/dyn/compute_alpha.zoneQueuedResources.html @@ -473,7 +473,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -723,11 +723,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -1020,7 +1015,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1270,11 +1265,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1586,7 +1576,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1817,6 +1807,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -1832,11 +1829,13 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. - "zones": [ # List with zones where bulk will create instances. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. { - "zone": "A String", # The URL of thezone. + "zone": "A String", # The URL of the zone. # The zone must exist in the region where the request is called. - # Zones must be represented as valid internal URLs, + # Zones must be represented as valid partial URLs, # such as zones/us-central1-a. }, ], @@ -2996,7 +2995,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3246,11 +3245,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -3543,7 +3537,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3793,11 +3787,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -4109,7 +4098,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -4340,6 +4329,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -4355,11 +4351,13 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. - "zones": [ # List with zones where bulk will create instances. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. { - "zone": "A String", # The URL of thezone. + "zone": "A String", # The URL of the zone. # The zone must exist in the region where the request is called. - # Zones must be represented as valid internal URLs, + # Zones must be represented as valid partial URLs, # such as zones/us-central1-a. }, ], @@ -4835,7 +4833,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5085,11 +5083,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -5382,7 +5375,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5632,11 +5625,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -5948,7 +5936,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -6179,6 +6167,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -6194,11 +6189,13 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. - "zones": [ # List with zones where bulk will create instances. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. { - "zone": "A String", # The URL of thezone. + "zone": "A String", # The URL of the zone. # The zone must exist in the region where the request is called. - # Zones must be represented as valid internal URLs, + # Zones must be represented as valid partial URLs, # such as zones/us-central1-a. }, ], @@ -7050,7 +7047,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7300,11 +7297,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -7597,7 +7589,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7847,11 +7839,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -8163,7 +8150,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -8394,6 +8381,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -8409,11 +8403,13 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. - "zones": [ # List with zones where bulk will create instances. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. { - "zone": "A String", # The URL of thezone. + "zone": "A String", # The URL of the zone. # The zone must exist in the region where the request is called. - # Zones must be represented as valid internal URLs, + # Zones must be represented as valid partial URLs, # such as zones/us-central1-a. }, ], diff --git a/docs/dyn/compute_alpha.zoneVmExtensionPolicies.html b/docs/dyn/compute_alpha.zoneVmExtensionPolicies.html index 5d85f636614..131ef36db7c 100644 --- a/docs/dyn/compute_alpha.zoneVmExtensionPolicies.html +++ b/docs/dyn/compute_alpha.zoneVmExtensionPolicies.html @@ -424,8 +424,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -471,7 +471,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. @@ -518,8 +518,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -565,7 +565,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. @@ -971,8 +971,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -1018,7 +1018,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. @@ -1261,8 +1261,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -1308,7 +1308,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. diff --git a/docs/dyn/compute_beta.backendServices.html b/docs/dyn/compute_beta.backendServices.html index 22d5b8b653e..f8211aa8627 100644 --- a/docs/dyn/compute_beta.backendServices.html +++ b/docs/dyn/compute_beta.backendServices.html @@ -683,6 +683,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -1513,6 +1517,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -2672,6 +2681,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -3502,6 +3515,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -5173,6 +5191,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -6003,6 +6025,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -6873,6 +6900,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -7703,6 +7734,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -8334,6 +8370,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -9164,6 +9204,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -9738,6 +9783,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -10568,6 +10617,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -12834,6 +12888,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -13664,6 +13722,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is diff --git a/docs/dyn/compute_beta.disks.html b/docs/dyn/compute_beta.disks.html index 208d34bc690..afffd2e2070 100644 --- a/docs/dyn/compute_beta.disks.html +++ b/docs/dyn/compute_beta.disks.html @@ -797,7 +797,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1075,14 +1075,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -1196,6 +1188,23 @@

Method Details

# - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup # - zones/zone/instantSnapshotGroups/instantSnapshotGroup }, + "snapshotGroupParameters": { # The parameters for the snapshot group. + "replicaZones": [ # URLs of the zones where disks should be replicated to. Only applicable + # for regional resources. + "A String", + ], + "sourceSnapshotGroup": "A String", # The source snapshot group used to create disks. You can provide this as a + # partial or full URL to the resource. For example, the following are valid + # values: + # + # + # - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup + # - projects/project/global/snapshotGroups/snapshotGroup + # - global/snapshotGroups/snapshotGroup + "type": "A String", # URL of the disk type resource describing which disk type to use to create + # disks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk + # types. + }, "sourceConsistencyGroupPolicy": "A String", # The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. # This may be a full or partial URL, such as: # @@ -1894,7 +1903,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1974,6 +1983,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -2119,10 +2131,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } guestFlush: boolean, [Input Only] Whether to attempt an application consistent snapshot by @@ -2950,7 +2958,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3228,14 +3236,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -3878,7 +3878,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4156,14 +4156,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -4798,7 +4790,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5076,14 +5068,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -7826,7 +7810,7 @@

Method Details

update(project, zone, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)
Updates the specified disk with the data included in the request.
 The update is performed only on selected fields included as part
-of update-mask. Only the following fields can be modified: user_license.
+of update-mask.
 
 Args:
   project: string, Project ID for this request. (required)
@@ -8084,7 +8068,7 @@ 

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -8362,14 +8346,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", diff --git a/docs/dyn/compute_beta.globalVmExtensionPolicies.html b/docs/dyn/compute_beta.globalVmExtensionPolicies.html index ece4c85f42e..37fb413b2db 100644 --- a/docs/dyn/compute_beta.globalVmExtensionPolicies.html +++ b/docs/dyn/compute_beta.globalVmExtensionPolicies.html @@ -222,8 +222,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -269,7 +269,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. diff --git a/docs/dyn/compute_beta.html b/docs/dyn/compute_beta.html index 843604ba712..3289f237e2d 100644 --- a/docs/dyn/compute_beta.html +++ b/docs/dyn/compute_beta.html @@ -614,6 +614,11 @@

Instance Methods

Returns the serviceAttachments Resource.

+

+ snapshotGroups() +

+

Returns the snapshotGroups Resource.

+

snapshotSettings()

diff --git a/docs/dyn/compute_beta.imageFamilyViews.html b/docs/dyn/compute_beta.imageFamilyViews.html index da35af6342a..ecb47eddfa4 100644 --- a/docs/dyn/compute_beta.imageFamilyViews.html +++ b/docs/dyn/compute_beta.imageFamilyViews.html @@ -323,7 +323,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -636,14 +636,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], }, }
diff --git a/docs/dyn/compute_beta.images.html b/docs/dyn/compute_beta.images.html index 5d437f86e82..9c53b32783c 100644 --- a/docs/dyn/compute_beta.images.html +++ b/docs/dyn/compute_beta.images.html @@ -960,7 +960,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1273,14 +1273,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } @@ -1520,7 +1512,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1833,14 +1825,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } @@ -2440,7 +2424,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2753,14 +2737,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } forceCreate: boolean, Force image creation if true. @@ -3362,7 +3338,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3675,14 +3651,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], }, ], "kind": "compute#imageList", # Output only. Type of resource. @@ -3964,7 +3932,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4277,14 +4245,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so diff --git a/docs/dyn/compute_beta.instanceGroupManagers.html b/docs/dyn/compute_beta.instanceGroupManagers.html index 2339673fa17..7a06f44ccf4 100644 --- a/docs/dyn/compute_beta.instanceGroupManagers.html +++ b/docs/dyn/compute_beta.instanceGroupManagers.html @@ -89,6 +89,9 @@

Instance Methods

close()

Close httplib2 connections.

+

+ configureAcceleratorTopologies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

+

Updates the accelerator topologies configuration.

createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)

Creates instances with per-instance configurations in this managed instance

@@ -960,7 +963,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1210,11 +1213,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -1300,7 +1298,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -2152,6 +2150,300 @@

Method Details

Close httplib2 connections.
+
+ configureAcceleratorTopologies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None) +
Updates the accelerator topologies configuration.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of thezone
+where the managed instance group is located.
+It should conform to RFC1035. (required)
+  instanceGroupManager: string, The name of the managed instance group.
+It should conform to RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # InstanceGroupManagers.ConfigureAcceleratorTopologies
+  "acceleratorTopologyActions": { # Map of accelerator topologies that should have their state changed to
+      # the specified value. The key is the hashed topology locus id. It can be
+      # obtained from the GetAvailableAcceleratorTopologies rpc.
+    "a_key": "A String",
+  },
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource.
+    #
+    # Google Compute Engine has three Operation resources:
+    #
+    # * [Global](/compute/docs/reference/rest/beta/globalOperations)
+    # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
+    # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
+    #
+    # You can use an operation resource to manage asynchronous API requests.
+    # For more information, readHandling
+    # API responses.
+    #
+    # Operations can be global, regional or zonal.
+    #
+    #    - For global operations, use the `globalOperations`
+    #    resource.
+    #    - For regional operations, use the
+    #    `regionOperations` resource.
+    #    - For zonal operations, use
+    #    the `zoneOperations` resource.
+    #
+    #
+    #
+    # For more information, read
+    # Global, Regional, and Zonal Resources.
+    #
+    # Note that completed Operation resources have a limited
+    # retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request.
+      # Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is
+      # set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339
+      # text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation,
+      # this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this
+        # operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error
+            # details. There is a set of defined message types to use for providing
+            # details.The syntax depends on the error code. For example,
+            # QuotaExceededInfo will have details when the error code is
+            # QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details.
+                #
+                # Example of an error when contacting the "pubsub.googleapis.com" API when it
+                # is not enabled:
+                #
+                #     { "reason": "API_DISABLED"
+                #       "domain": "googleapis.com"
+                #       "metadata": {
+                #         "resource": "projects/123",
+                #         "service": "pubsub.googleapis.com"
+                #       }
+                #     }
+                #
+                # This response indicates that the pubsub.googleapis.com API is not enabled.
+                #
+                # Example of an error that is returned when attempting to create a Spanner
+                # instance in a region that is out of stock:
+                #
+                #     { "reason": "STOCKOUT"
+                #       "domain": "spanner.googleapis.com",
+                #       "metadata": {
+                #         "availableRegions": "us-central1,us-east2"
+                #       }
+                #     }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain
+                  # is typically the registered service name of the tool or product that
+                  # generates the error. Example: "pubsub.googleapis.com". If the error is
+                  # generated by some common infrastructure, the error domain must be a
+                  # globally unique value that identifies the infrastructure. For Google API
+                  # infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error.
+                  #
+                  # Keys must match a regular expression of `a-z+` but should
+                  # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
+                  # length. When identifying the current value of an exceeded limit, the units
+                  # should be contained in the key, not the value.  For example, rather than
+                  # `{"instanceLimit": "100/request"}`, should be returned as,
+                  # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of
+                  # instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the
+                  # proximate cause of the error. Error reasons are unique within a particular
+                  # domain of errors. This should be at most 63 characters and match a
+                  # regular expression of `A-Z+[A-Z0-9]`, which represents
+                  # UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action.
+                #
+                # For example, if a quota check failed with an error indicating the calling
+                # project hasn't enabled the accessed service, this can contain a URL pointing
+                # directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user
+                # which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at
+                  # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+                  # Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota
+                  #  type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type
+                  # or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error.
+            # This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error
+      # message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error
+      # status code that was returned. For example, a `404` means the
+      # resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is
+      # defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested.
+      # This value is inRFC3339
+      # text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an
+            # error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information
+            # if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for
+      # Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a
+      # group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`,
+      # `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
+      # There is no requirement that this be linear or support any granularity of
+      # operations. This should not be used to guess when the operation will be
+      # complete. This number should monotonically increase as the operation
+      # progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only
+      # applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
+      # this field will contain information on all underlying zonal actions and
+      # their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
+            # populated.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any
+              # user-facing error message should be localized and sent in the
+              # google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following:
+            # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server.
+      # This value is inRFC3339
+      # text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the
+      # following:
+      # `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the
+      # operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation
+      # of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For
+      # operations related to creating a snapshot, this points to the disk
+      # that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example:
+      # `user@example.com` or
+      # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the
+      # operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+          # Engine returns NO_RESULTS_ON_PAGE if there
+          # are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key:
+          # value format. For example:
+          #
+          # "data": [
+          #   {
+          #    "key": "scope",
+          #    "value": "zones/us-east1-d"
+          #   }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being
+              # returned. For example, for warnings where there are no results in a list
+              # request for a particular zone, this key might be scope and
+              # the key value might be the zone name. Other examples might be a key
+              # indicating a deprecated resource and a suggested replacement, or a
+              # warning about invalid network settings (for example, if an instance
+              # attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only
+      # applicable when performing per-zone operations.
+}
+
+
createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)
Creates instances with per-instance configurations in this managed instance
@@ -3770,7 +4062,7 @@ 

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4020,11 +4312,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -4110,7 +4397,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -4587,8 +4874,113 @@

Method Details

"a_key": { "acceleratorTopology": "A String", # Topology in the format of: "16x16", "4x4x4", etc. "acceleratorTopologyHealth": "A String", + "acceleratorTopologyState": { # Specifies the topology state + "currentState": "A String", + "error": { # Reason why the topology state change failed + "errors": [ # [Output Only] The array of errors encountered while processing this + # operation. + { + "code": "A String", # [Output Only] The error type identifier for this error. + "errorDetails": [ # [Output Only] An optional list of messages that contain the error + # details. There is a set of defined message types to use for providing + # details.The syntax depends on the error code. For example, + # QuotaExceededInfo will have details when the error code is + # QUOTA_EXCEEDED. + { + "errorInfo": { # Describes the cause of the error with structured details. + # + # Example of an error when contacting the "pubsub.googleapis.com" API when it + # is not enabled: + # + # { "reason": "API_DISABLED" + # "domain": "googleapis.com" + # "metadata": { + # "resource": "projects/123", + # "service": "pubsub.googleapis.com" + # } + # } + # + # This response indicates that the pubsub.googleapis.com API is not enabled. + # + # Example of an error that is returned when attempting to create a Spanner + # instance in a region that is out of stock: + # + # { "reason": "STOCKOUT" + # "domain": "spanner.googleapis.com", + # "metadata": { + # "availableRegions": "us-central1,us-east2" + # } + # } + "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain + # is typically the registered service name of the tool or product that + # generates the error. Example: "pubsub.googleapis.com". If the error is + # generated by some common infrastructure, the error domain must be a + # globally unique value that identifies the infrastructure. For Google API + # infrastructure, the error domain is "googleapis.com". + "metadatas": { # Additional structured details about this error. + # + # Keys must match a regular expression of `a-z+` but should + # ideally be lowerCamelCase. Also, they must be limited to 64 characters in + # length. When identifying the current value of an exceeded limit, the units + # should be contained in the key, not the value. For example, rather than + # `{"instanceLimit": "100/request"}`, should be returned as, + # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of + # instances that can be created in a single (batch) request. + "a_key": "A String", + }, + "reason": "A String", # The reason of the error. This is a constant value that identifies the + # proximate cause of the error. Error reasons are unique within a particular + # domain of errors. This should be at most 63 characters and match a + # regular expression of `A-Z+[A-Z0-9]`, which represents + # UPPER_SNAKE_CASE. + }, + "help": { # Provides links to documentation or for performing an out of band action. + # + # For example, if a quota check failed with an error indicating the calling + # project hasn't enabled the accessed service, this can contain a URL pointing + # directly to the right place in the developer console to flip the bit. + "links": [ # URL(s) pointing to additional information on handling the current error. + { # Describes a URL link. + "description": "A String", # Describes what the link offers. + "url": "A String", # The URL of the link. + }, + ], + }, + "localizedMessage": { # Provides a localized error message that is safe to return to the user + # which can be attached to an RPC error. + "locale": "A String", # The locale used following the specification defined at + # https://www.rfc-editor.org/rfc/bcp/bcp47.txt. + # Examples are: "en-US", "fr-CH", "es-MX" + "message": "A String", # The localized error message in the above locale. + }, + "quotaInfo": { # Additional details for quota exceeded error for resource quota. + "dimensions": { # The map holding related quota dimensions. + "a_key": "A String", + }, + "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota + # type or metric. + "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type + # or metric. + "limitName": "A String", # The name of the quota limit. + "metricName": "A String", # The Compute Engine quota metric name. + "rolloutStatus": "A String", # Rollout status of the future quota limit. + }, + }, + ], + "location": "A String", # [Output Only] Indicates the field in the request that caused the error. + # This property is optional. + "message": "A String", # [Output Only] An optional, human-readable error message. + }, + ], + }, + "errorTimestamp": "A String", # Timestamp when the last error happened + }, + "instancesHealth": "A String", + "parent": "A String", # Identified by the topology Id in the accelerator_topology_info map. Empty + # for the top-level topology }, }, + "multiMig": "A String", # URL to MMIG this MIG belongs to. }
@@ -4971,7 +5363,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5221,11 +5613,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -5311,7 +5698,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -6496,7 +6883,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -6746,11 +7133,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -6836,7 +7218,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -8065,7 +8447,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -8315,11 +8697,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineType": "A String", # Output only. The machine type to be used for this instance. @@ -8980,7 +9357,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9230,11 +9607,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -9320,7 +9692,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -13908,7 +14280,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -14158,11 +14530,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -14248,7 +14615,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and diff --git a/docs/dyn/compute_beta.instanceTemplates.html b/docs/dyn/compute_beta.instanceTemplates.html index f270eec29ae..8f051ea9ed6 100644 --- a/docs/dyn/compute_beta.instanceTemplates.html +++ b/docs/dyn/compute_beta.instanceTemplates.html @@ -519,7 +519,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -769,11 +769,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1050,7 +1045,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1955,7 +1950,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2205,11 +2200,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -2486,7 +2476,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -3389,7 +3379,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3639,11 +3629,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -3920,7 +3905,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -4820,7 +4805,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5070,11 +5055,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -5351,7 +5331,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_beta.instances.html b/docs/dyn/compute_beta.instances.html index fea56f04dc1..dc4f8475a2f 100644 --- a/docs/dyn/compute_beta.instances.html +++ b/docs/dyn/compute_beta.instances.html @@ -1724,7 +1724,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1974,11 +1974,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -2355,7 +2350,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3040,7 +3035,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3290,11 +3285,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], } forceAttach: boolean, Whether to force attach the regional disk even if it's currently attached @@ -3832,7 +3822,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4082,11 +4072,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -4367,7 +4352,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4617,11 +4602,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -4898,7 +4878,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -5083,6 +5063,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -5093,6 +5080,16 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. + { + "zone": "A String", # The URL of the zone. + # The zone must exist in the region where the request is called. + # Zones must be represented as valid partial URLs, + # such as zones/us-central1-a. + }, + ], }, "minCount": "A String", # The minimum number of instances to create. If no min_count is # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will @@ -6837,7 +6834,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7087,11 +7084,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -7468,7 +7460,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9754,7 +9746,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -10004,11 +9996,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -10385,7 +10372,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -11415,7 +11402,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -11665,11 +11652,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -12046,7 +12028,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -21436,7 +21418,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -21686,11 +21668,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Enables display device for the instance. @@ -22067,7 +22044,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced diff --git a/docs/dyn/compute_beta.machineImages.html b/docs/dyn/compute_beta.machineImages.html index 93870f75182..b87704a6eb5 100644 --- a/docs/dyn/compute_beta.machineImages.html +++ b/docs/dyn/compute_beta.machineImages.html @@ -684,7 +684,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -934,11 +934,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1215,7 +1210,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -2761,7 +2756,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3011,11 +3006,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -3292,7 +3282,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -4831,7 +4821,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5081,11 +5071,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -5362,7 +5347,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_beta.regionBackendServices.html b/docs/dyn/compute_beta.regionBackendServices.html index 335a87e3461..75dcfec2a52 100644 --- a/docs/dyn/compute_beta.regionBackendServices.html +++ b/docs/dyn/compute_beta.regionBackendServices.html @@ -556,6 +556,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -1386,6 +1390,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -2320,6 +2329,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -3150,6 +3163,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -4021,6 +4039,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -4851,6 +4873,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -5485,6 +5512,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -6315,6 +6346,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -6890,6 +6926,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -7720,6 +7760,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -9703,6 +9748,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -10533,6 +10582,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is diff --git a/docs/dyn/compute_beta.regionCommitments.html b/docs/dyn/compute_beta.regionCommitments.html index ba5febc2db8..ce950f7c829 100644 --- a/docs/dyn/compute_beta.regionCommitments.html +++ b/docs/dyn/compute_beta.regionCommitments.html @@ -371,6 +371,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -832,6 +844,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -1203,6 +1227,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -1937,6 +1973,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -2393,6 +2441,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -2970,6 +3030,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). diff --git a/docs/dyn/compute_beta.regionDisks.html b/docs/dyn/compute_beta.regionDisks.html index a199f840610..84a0363cbe3 100644 --- a/docs/dyn/compute_beta.regionDisks.html +++ b/docs/dyn/compute_beta.regionDisks.html @@ -447,6 +447,23 @@

Method Details

# - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup # - zones/zone/instantSnapshotGroups/instantSnapshotGroup }, + "snapshotGroupParameters": { # The parameters for the snapshot group. + "replicaZones": [ # URLs of the zones where disks should be replicated to. Only applicable + # for regional resources. + "A String", + ], + "sourceSnapshotGroup": "A String", # The source snapshot group used to create disks. You can provide this as a + # partial or full URL to the resource. For example, the following are valid + # values: + # + # + # - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup + # - projects/project/global/snapshotGroups/snapshotGroup + # - global/snapshotGroups/snapshotGroup + "type": "A String", # URL of the disk type resource describing which disk type to use to create + # disks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk + # types. + }, "sourceConsistencyGroupPolicy": "A String", # The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. # This may be a full or partial URL, such as: # @@ -844,7 +861,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -924,6 +941,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -1069,10 +1089,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so @@ -1898,7 +1914,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2176,14 +2192,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -2823,7 +2831,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3101,14 +3109,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -3743,7 +3743,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4021,14 +4021,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", @@ -6768,8 +6760,7 @@

Method Details

update(project, region, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)
Update the specified disk with the data included in the request. Update is
-performed only on selected fields included as part of update-mask. Only the
-following fields can be modified: user_license.
+performed only on selected fields included as part of update-mask.
 
 Args:
   project: string, Project ID for this request. (required)
@@ -7027,7 +7018,7 @@ 

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7305,14 +7296,6 @@

Method Details

"type": "A String", # URL of the disk type resource describing which disk type to use to create # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk # types. - "userLicenses": [ # A list of publicly visible user-licenses. Unlike regular licenses, user - # provided licenses can be modified after the disk is created. This includes - # a list of URLs to the license resource. For example, to provide a debian - # license: - # - # https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - "A String", - ], "users": [ # Output only. [Output Only] Links to the users of the disk (attached instances) # in form:projects/project/zones/zone/instances/instance "A String", diff --git a/docs/dyn/compute_beta.regionInstanceGroupManagers.html b/docs/dyn/compute_beta.regionInstanceGroupManagers.html index 511185e8c36..d64f02ba11d 100644 --- a/docs/dyn/compute_beta.regionInstanceGroupManagers.html +++ b/docs/dyn/compute_beta.regionInstanceGroupManagers.html @@ -2769,7 +2769,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3019,11 +3019,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -3109,7 +3104,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -3937,7 +3932,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4187,11 +4182,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -4277,7 +4267,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -5461,7 +5451,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5711,11 +5701,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -5801,7 +5786,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -7025,7 +7010,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7275,11 +7260,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineType": "A String", # Output only. The machine type to be used for this instance. @@ -7937,7 +7917,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -8187,11 +8167,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -8277,7 +8252,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and @@ -12831,7 +12806,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -13081,11 +13056,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Full machine-type names, e.g. "n1-standard-16". @@ -13171,7 +13141,7 @@

Method Details

], "params": { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to bind to the managed instance group. The tags are + "resourceManagerTags": { # Input only. Resource manager tags to bind to the managed instance group. The tags are # key-value pairs. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced # format such as `{org_id|project_id}/{tag_key_short_name}` and diff --git a/docs/dyn/compute_beta.regionInstanceTemplates.html b/docs/dyn/compute_beta.regionInstanceTemplates.html index 0ecee48fb2c..c89284dcb29 100644 --- a/docs/dyn/compute_beta.regionInstanceTemplates.html +++ b/docs/dyn/compute_beta.regionInstanceTemplates.html @@ -696,7 +696,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -946,11 +946,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1227,7 +1222,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1760,7 +1755,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2010,11 +2005,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -2291,7 +2281,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -3192,7 +3182,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3442,11 +3432,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -3723,7 +3708,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_beta.regionInstances.html b/docs/dyn/compute_beta.regionInstances.html index 925758b1d06..91452d19452 100644 --- a/docs/dyn/compute_beta.regionInstances.html +++ b/docs/dyn/compute_beta.regionInstances.html @@ -339,7 +339,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -589,11 +589,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "machineTypes": [ # Alternative machine types to use for instances that are created from @@ -874,7 +869,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1124,11 +1119,6 @@

Method Details

# Note that for InstanceTemplate, specify the disk name for zonal disk, # and the URL for regional disk. "type": "A String", # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. - "userLicenses": [ # Output only. [Output Only] A list of user provided licenses. It represents a list of - # URLs to the license resource. Unlike regular licenses, user provided - # licenses can be modified after the disk is created. - "A String", - ], }, ], "displayDevice": { # A set of Display Device options # Display Device properties to enable support @@ -1405,7 +1395,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1590,6 +1580,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -1600,6 +1597,16 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. + { + "zone": "A String", # The URL of the zone. + # The zone must exist in the region where the request is called. + # Zones must be represented as valid partial URLs, + # such as zones/us-central1-a. + }, + ], }, "minCount": "A String", # The minimum number of instances to create. If no min_count is # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will diff --git a/docs/dyn/compute_beta.regionSnapshots.html b/docs/dyn/compute_beta.regionSnapshots.html index 5eb4fa02fe5..cca4a00d9a7 100644 --- a/docs/dyn/compute_beta.regionSnapshots.html +++ b/docs/dyn/compute_beta.regionSnapshots.html @@ -505,7 +505,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -585,6 +585,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -730,10 +733,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }
@@ -1208,7 +1207,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1288,6 +1287,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -1433,10 +1435,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so @@ -1905,7 +1903,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1985,6 +1983,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -2130,10 +2131,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, ], "kind": "compute#snapshotList", # Output only. Type of resource. diff --git a/docs/dyn/compute_beta.reservations.html b/docs/dyn/compute_beta.reservations.html index d35d236dd25..eeb9290a1da 100644 --- a/docs/dyn/compute_beta.reservations.html +++ b/docs/dyn/compute_beta.reservations.html @@ -312,6 +312,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -923,6 +935,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -1533,6 +1557,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -2138,6 +2174,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -3917,6 +3965,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). diff --git a/docs/dyn/compute_beta.routers.html b/docs/dyn/compute_beta.routers.html index c3e3c2ec833..b08c8c9b98c 100644 --- a/docs/dyn/compute_beta.routers.html +++ b/docs/dyn/compute_beta.routers.html @@ -86,12 +86,18 @@

Instance Methods

delete(project, region, router, requestId=None, x__xgafv=None)

Deletes the specified Router resource.

+

+ deleteNamedSet(project, region, router, namedSet=None, requestId=None, x__xgafv=None)

+

Deletes Named Set

deleteRoutePolicy(project, region, router, policy=None, requestId=None, x__xgafv=None)

Deletes Route Policy

get(project, region, router, x__xgafv=None)

Returns the specified Router resource.

+

+ getNamedSet(project, region, router, namedSet=None, x__xgafv=None)

+

Returns specified Named Set

getNatIpInfo(project, region, router, natName=None, x__xgafv=None)

Retrieves runtime NAT IP information.

@@ -119,6 +125,12 @@

Instance Methods

listBgpRoutes_next()

Retrieves the next page of results.

+

+ listNamedSets(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

+

Retrieves a list of router named set subresources available to the

+

+ listNamedSets_next()

+

Retrieves the next page of results.

listRoutePolicies(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves a list of router route policy subresources available to the

@@ -131,6 +143,9 @@

Instance Methods

patch(project, region, router, body=None, requestId=None, x__xgafv=None)

Patches the specified Router resource with the data included in the

+

+ patchNamedSet(project, region, router, body=None, requestId=None, x__xgafv=None)

+

Patches Named Set

patchRoutePolicy(project, region, router, body=None, requestId=None, x__xgafv=None)

Patches Route Policy

@@ -143,6 +158,9 @@

Instance Methods

update(project, region, router, body=None, requestId=None, x__xgafv=None)

Updates the specified Router resource with the data included in the

+

+ updateNamedSet(project, region, router, body=None, requestId=None, x__xgafv=None)

+

Updates or creates new Named Set

updateRoutePolicy(project, region, router, body=None, requestId=None, x__xgafv=None)

Updates or creates new Route Policy

@@ -1139,14 +1157,14 @@

Method Details

- deleteRoutePolicy(project, region, router, policy=None, requestId=None, x__xgafv=None) -
Deletes Route Policy
+    deleteNamedSet(project, region, router, namedSet=None, requestId=None, x__xgafv=None)
+  
Deletes Named Set
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region for this request. (required)
-  router: string, Name of the Router resource where Route Policy is defined. (required)
-  policy: string, The Policy name for this request. Name must conform to RFC1035
+  router: string, Name of the Router resource where Named Set is defined. (required)
+  namedSet: string, The Named Set name for this request. Name must conform to RFC1035
   requestId: string, An optional request ID to identify requests. Specify a unique request ID so
 that if you must retry your request, the server will know to ignore the
 request if it has already been completed.
@@ -1421,13 +1439,27 @@ 

Method Details

- get(project, region, router, x__xgafv=None) -
Returns the specified Router resource.
+    deleteRoutePolicy(project, region, router, policy=None, requestId=None, x__xgafv=None)
+  
Deletes Route Policy
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region for this request. (required)
-  router: string, Name of the Router resource to return. (required)
+  router: string, Name of the Router resource where Route Policy is defined. (required)
+  policy: string, The Policy name for this request. Name must conform to RFC1035
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -1436,106 +1468,374 @@ 

Method Details

Returns: An object of the form: - { # Represents a Cloud Router resource. + { # Represents an Operation resource. # - # For more information about Cloud Router, read theCloud - # Router overview. - "bgp": { # BGP information specific to this router. - "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement. - # The options are DEFAULT or CUSTOM. - "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode. - # This field can only be populated if advertise_mode is CUSTOM and - # is advertised to all peers of the router. - # These groups will be advertised in addition to any specified prefixes. - # Leave this field blank to advertise no custom groups. - "A String", - ], - "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode. - # This field can only be populated if advertise_mode is CUSTOM and - # is advertised to all peers of the router. - # These IP ranges will be advertised in addition to any specified groups. - # Leave this field blank to advertise no custom IP ranges. - { # Description-tagged IP ranges for the router to advertise. - "description": "A String", # User-specified description for the IP range. - "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string. + # Google Compute Engine has three Operation resources: + # + # * [Global](/compute/docs/reference/rest/beta/globalOperations) + # * [Regional](/compute/docs/reference/rest/beta/regionOperations) + # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations) + # + # You can use an operation resource to manage asynchronous API requests. + # For more information, readHandling + # API responses. + # + # Operations can be global, regional or zonal. + # + # - For global operations, use the `globalOperations` + # resource. + # - For regional operations, use the + # `regionOperations` resource. + # - For zonal operations, use + # the `zoneOperations` resource. + # + # + # + # For more information, read + # Global, Regional, and Zonal Resources. + # + # Note that completed Operation resources have a limited + # retention period. + "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. + # Not present otherwise. + "creationTimestamp": "A String", # [Deprecated] This field is deprecated. + "description": "A String", # [Output Only] A textual description of the operation, which is + # set when the operation is created. + "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339 + # text format. + "error": { # [Output Only] If errors are generated during processing of the operation, + # this field will be populated. + "errors": [ # [Output Only] The array of errors encountered while processing this + # operation. + { + "code": "A String", # [Output Only] The error type identifier for this error. + "errorDetails": [ # [Output Only] An optional list of messages that contain the error + # details. There is a set of defined message types to use for providing + # details.The syntax depends on the error code. For example, + # QuotaExceededInfo will have details when the error code is + # QUOTA_EXCEEDED. + { + "errorInfo": { # Describes the cause of the error with structured details. + # + # Example of an error when contacting the "pubsub.googleapis.com" API when it + # is not enabled: + # + # { "reason": "API_DISABLED" + # "domain": "googleapis.com" + # "metadata": { + # "resource": "projects/123", + # "service": "pubsub.googleapis.com" + # } + # } + # + # This response indicates that the pubsub.googleapis.com API is not enabled. + # + # Example of an error that is returned when attempting to create a Spanner + # instance in a region that is out of stock: + # + # { "reason": "STOCKOUT" + # "domain": "spanner.googleapis.com", + # "metadata": { + # "availableRegions": "us-central1,us-east2" + # } + # } + "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain + # is typically the registered service name of the tool or product that + # generates the error. Example: "pubsub.googleapis.com". If the error is + # generated by some common infrastructure, the error domain must be a + # globally unique value that identifies the infrastructure. For Google API + # infrastructure, the error domain is "googleapis.com". + "metadatas": { # Additional structured details about this error. + # + # Keys must match a regular expression of `a-z+` but should + # ideally be lowerCamelCase. Also, they must be limited to 64 characters in + # length. When identifying the current value of an exceeded limit, the units + # should be contained in the key, not the value. For example, rather than + # `{"instanceLimit": "100/request"}`, should be returned as, + # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of + # instances that can be created in a single (batch) request. + "a_key": "A String", + }, + "reason": "A String", # The reason of the error. This is a constant value that identifies the + # proximate cause of the error. Error reasons are unique within a particular + # domain of errors. This should be at most 63 characters and match a + # regular expression of `A-Z+[A-Z0-9]`, which represents + # UPPER_SNAKE_CASE. + }, + "help": { # Provides links to documentation or for performing an out of band action. + # + # For example, if a quota check failed with an error indicating the calling + # project hasn't enabled the accessed service, this can contain a URL pointing + # directly to the right place in the developer console to flip the bit. + "links": [ # URL(s) pointing to additional information on handling the current error. + { # Describes a URL link. + "description": "A String", # Describes what the link offers. + "url": "A String", # The URL of the link. + }, + ], + }, + "localizedMessage": { # Provides a localized error message that is safe to return to the user + # which can be attached to an RPC error. + "locale": "A String", # The locale used following the specification defined at + # https://www.rfc-editor.org/rfc/bcp/bcp47.txt. + # Examples are: "en-US", "fr-CH", "es-MX" + "message": "A String", # The localized error message in the above locale. + }, + "quotaInfo": { # Additional details for quota exceeded error for resource quota. + "dimensions": { # The map holding related quota dimensions. + "a_key": "A String", + }, + "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota + # type or metric. + "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type + # or metric. + "limitName": "A String", # The name of the quota limit. + "metricName": "A String", # The Compute Engine quota metric name. + "rolloutStatus": "A String", # Rollout status of the future quota limit. + }, + }, + ], + "location": "A String", # [Output Only] Indicates the field in the request that caused the error. + # This property is optional. + "message": "A String", # [Output Only] An optional, human-readable error message. }, ], - "asn": 42, # Local BGP Autonomous System Number (ASN). - # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The - # value will be fixed for this router resource. All VPN tunnels that link - # to this router will have the same local ASN. - "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It - # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at - # least /30, even if the BGP sessions are over IPv6. It must not overlap - # with any IPv4 BGP session ranges. - # - # - # Other vendors commonly call this "router ID". - "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are - # sent to the peer. - # - # - # Hold time is three times the interval at which keepalive messages are - # sent, and the hold time is the maximum number of seconds allowed to - # elapse between successive keepalive messages that BGP receives from a - # peer. - # - # - # BGP will use the smaller of either the local hold time value or the - # peer's hold time value as the hold time for the BGP connection between - # the two peers. - # - # - # If set, this value must be between 20 and 60. The default is 20. }, - "bgpPeers": [ # BGP information that must be configured into the routing stack to - # establish BGP peering. This information must specify the peer ASN and - # either the interface name, IP address, or peer IP address. Please refer toRFC4273. - { - "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement. - "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode, - # which currently supports the following option: - # - # - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This - # excludes any routes learned for subnets that use - # VPC Network Peering. - # - # - # Note that this field can only be populated if advertise_mode is CUSTOM - # and overrides the list defined for the router (in the "bgp" message). - # These groups are advertised in addition to any specified prefixes. - # Leave this field blank to advertise no custom groups. - "A String", - ], - "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode. - # This field can only be populated if advertise_mode is CUSTOM and - # overrides the list defined for the router (in the "bgp" message). - # These IP ranges are advertised in addition to any specified groups. - # Leave this field blank to advertise no custom IP ranges. - { # Description-tagged IP ranges for the router to advertise. - "description": "A String", # User-specified description for the IP range. - "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string. - }, - ], - "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more - # than one matching route of maximum length, the routes with the lowest - # priority value win. - "bfd": { # BFD configuration for the BGP peering. - "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets - # received from the peer router. The actual value is negotiated between - # the two routers and is equal to the greater of this value and the - # transmit interval of the other router. - # - # - # If set, this value must be between 1000 and 30000. - # - # - # The default is 1000. - "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets - # transmitted to the peer router. The actual value is negotiated between - # the two routers and is equal to the greater of this value and the - # corresponding receive interval of the other router. - # + "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error + # message that was returned, such as `NOT FOUND`. + "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error + # status code that was returned. For example, a `404` means the + # resource was not found. + "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is + # defined by the server. + "insertTime": "A String", # [Output Only] The time that this operation was requested. + # This value is inRFC3339 + # text format. + "instancesBulkInsertOperationMetadata": { + "perLocationStatus": { # Status information per location (location name is key). + # Example key: zones/us-central1-a + "a_key": { + "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far. + "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback. + "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an + # error. + "status": "A String", # [Output Only] Creation status of BulkInsert operation - information + # if the flow is rolling forward or rolling back. + "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created. + }, + }, + }, + "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for + # Operation resources. + "name": "A String", # [Output Only] Name of the operation. + "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a + # group of operations results from a `bulkInsert` API request. + "operationType": "A String", # [Output Only] The type of operation, such as `insert`, + # `update`, or `delete`, and so on. + "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. + # There is no requirement that this be linear or support any granularity of + # operations. This should not be used to guess when the operation will be + # complete. This number should monotonically increase as the operation + # progresses. + "region": "A String", # [Output Only] The URL of the region where the operation resides. Only + # applicable when performing regional operations. + "selfLink": "A String", # [Output Only] Server-defined URL for the resource. + "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata, + # this field will contain information on all underlying zonal actions and + # their state. + "clientOperationId": "A String", # [Output Only] The client operation id. + "perLocationOperations": { # [Output Only] Status information per location (location name is key). + # Example key: zones/us-central1-a + "a_key": { + "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is + # populated. + # different programming environments, including REST APIs and RPC APIs. It is + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. + # + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). + "code": 42, # The status code, which should be an enum value of google.rpc.Code. + "details": [ # A list of messages that carry the error details. There is a common set of + # message types for APIs to use. + { + "a_key": "", # Properties of the object. Contains field @type with type URL. + }, + ], + "message": "A String", # A developer-facing error message, which should be in English. Any + # user-facing error message should be localized and sent in the + # google.rpc.Status.details field, or localized by the client. + }, + "state": "A String", # [Output Only] Status of the action, which can be one of the following: + # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. + }, + }, + }, + "startTime": "A String", # [Output Only] The time that this operation was started by the server. + # This value is inRFC3339 + # text format. + "status": "A String", # [Output Only] The status of the operation, which can be one of the + # following: + # `PENDING`, `RUNNING`, or `DONE`. + "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the + # operation. + "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation + # of the target resource. + "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For + # operations related to creating a snapshot, this points to the disk + # that the snapshot was created from. + "user": "A String", # [Output Only] User who requested the operation, for example: + # `user@example.com` or + # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. + "warnings": [ # [Output Only] If warning messages are generated during processing of the + # operation, this field will be populated. + { + "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute + # Engine returns NO_RESULTS_ON_PAGE if there + # are no results in the response. + "data": [ # [Output Only] Metadata about this warning in key: + # value format. For example: + # + # "data": [ + # { + # "key": "scope", + # "value": "zones/us-east1-d" + # } + { + "key": "A String", # [Output Only] A key that provides more detail on the warning being + # returned. For example, for warnings where there are no results in a list + # request for a particular zone, this key might be scope and + # the key value might be the zone name. Other examples might be a key + # indicating a deprecated resource and a suggested replacement, or a + # warning about invalid network settings (for example, if an instance + # attempts to perform IP forwarding but is not enabled for IP forwarding). + "value": "A String", # [Output Only] A warning data value corresponding to the key. + }, + ], + "message": "A String", # [Output Only] A human-readable description of the warning code. + }, + ], + "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only + # applicable when performing per-zone operations. +}
+
+ +
+ get(project, region, router, x__xgafv=None) +
Returns the specified Router resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  router: string, Name of the Router resource to return. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a Cloud Router resource.
+    #
+    # For more information about Cloud Router, read theCloud
+    # Router overview.
+  "bgp": { # BGP information specific to this router.
+    "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+        # The options are DEFAULT or CUSTOM.
+    "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These groups will be advertised in addition to any specified prefixes.
+        # Leave this field blank to advertise no custom groups.
+      "A String",
+    ],
+    "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These IP ranges will be advertised in addition to any specified groups.
+        # Leave this field blank to advertise no custom IP ranges.
+      { # Description-tagged IP ranges for the router to advertise.
+        "description": "A String", # User-specified description for the IP range.
+        "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
+      },
+    ],
+    "asn": 42, # Local BGP Autonomous System Number (ASN).
+        # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The
+        # value will be fixed for this router resource. All VPN tunnels that link
+        # to this router will have the same local ASN.
+    "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It
+        # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at
+        # least /30, even if the BGP sessions are over IPv6. It must not overlap
+        # with any IPv4 BGP session ranges.
+        #
+        #
+        # Other vendors commonly call this "router ID".
+    "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are
+        # sent to the peer.
+        #
+        #
+        # Hold time is three times the interval at which keepalive messages are
+        # sent, and the hold time is the maximum number of seconds allowed to
+        # elapse between successive keepalive messages that BGP receives from a
+        # peer.
+        #
+        #
+        # BGP will use the smaller of either the local hold time value or the
+        # peer's hold time value as the hold time for the BGP connection between
+        # the two peers.
+        #
+        #
+        # If set, this value must be between 20 and 60. The default is 20.
+  },
+  "bgpPeers": [ # BGP information that must be configured into the routing stack to
+      # establish BGP peering. This information must specify the peer ASN and
+      # either the interface name, IP address, or peer IP address. Please refer toRFC4273.
+    {
+      "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+      "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode,
+          # which currently supports the following option:
+          #
+          #    - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This
+          #    excludes any routes learned for subnets that use
+          #    VPC Network Peering.
+          #
+          #
+          # Note that this field can only be populated if advertise_mode is CUSTOM
+          # and overrides the list defined for the router (in the "bgp" message).
+          # These groups are advertised in addition to any specified prefixes.
+          # Leave this field blank to advertise no custom groups.
+        "A String",
+      ],
+      "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+          # This field can only be populated if advertise_mode is CUSTOM and
+          # overrides the list defined for the router (in the "bgp" message).
+          # These IP ranges are advertised in addition to any specified groups.
+          # Leave this field blank to advertise no custom IP ranges.
+        { # Description-tagged IP ranges for the router to advertise.
+          "description": "A String", # User-specified description for the IP range.
+          "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
+        },
+      ],
+      "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more
+          # than one matching route of maximum length, the routes with the lowest
+          # priority value win.
+      "bfd": { # BFD configuration for the BGP peering.
+        "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # received from the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # transmit interval of the other router.
+            #
+            #
+            # If set, this value must be between 1000 and 30000.
+            #
+            #
+            # The default is 1000.
+        "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # transmitted to the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # corresponding receive interval of the other router.
+            #
             #
             # If set, this value must be between 1000 and 30000.
             #
@@ -1949,17 +2249,15 @@ 

Method Details

- getNatIpInfo(project, region, router, natName=None, x__xgafv=None) -
Retrieves runtime NAT IP information.
+    getNamedSet(project, region, router, namedSet=None, x__xgafv=None)
+  
Returns specified Named Set
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region for this request. (required)
-  router: string, Name of the Router resource to query for Nat IP information. The name
-should conform to RFC1035. (required)
-  natName: string, Name of the nat service to filter the NAT IP information.
-If it is omitted, all nats for this router will be returned.
-Name should conform to RFC1035.
+  router: string, Name of the Router resource to query for the named set. The name should
+conform to RFC1035. (required)
+  namedSet: string, The Named Set name for this request. Name must conform to RFC1035
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -1969,19 +2267,103 @@ 

Method Details

An object of the form: { - "result": [ # [Output Only] A list of NAT IP information. - { # Contains NAT IP information of a NAT config (i.e. usage status, mode). - "natIpInfoMappings": [ # Output only. A list of all NAT IPs assigned to this NAT config. - { # Contains information of a NAT IP. - "mode": "A String", # Output only. Specifies whether NAT IP is auto or manual. - "natIp": "A String", # Output only. NAT IP address. For example: 203.0.113.11. - "usage": "A String", # Output only. Specifies whether NAT IP is currently serving at least one endpoint or - # not. - }, - ], - "natName": "A String", # Output only. Name of the NAT config which the NAT IP belongs to. - }, - ], + "etag": "A String", # end_interface: MixerGetResponseWithEtagBuilder + "resource": { + "description": "A String", # An optional description of named set. + "elements": [ # CEL expressions that are comparable to constructs of this set's type + # (see Policy Language). + { # Represents a textual expression in the Common Expression Language (CEL) + # syntax. CEL is a C-like expression language. The syntax and semantics of CEL + # are documented at https://github.com/google/cel-spec. + # + # Example (Comparison): + # + # title: "Summary size limit" + # description: "Determines if a summary is less than 100 chars" + # expression: "document.summary.size() < 100" + # + # Example (Equality): + # + # title: "Requestor is owner" + # description: "Determines if requestor is the document owner" + # expression: "document.owner == request.auth.claims.email" + # + # Example (Logic): + # + # title: "Public documents" + # description: "Determine whether the document should be publicly visible" + # expression: "document.type != 'private' && document.type != 'internal'" + # + # Example (Data Manipulation): + # + # title: "Notification string" + # description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" + # + # The exact variables and functions that may be referenced within an expression + # are determined by the service that evaluates it. See the service + # documentation for additional information. + "description": "A String", # Optional. Description of the expression. This is a longer text which + # describes the expression, e.g. when hovered over it in a UI. + "expression": "A String", # Textual representation of an expression in Common Expression Language + # syntax. + "location": "A String", # Optional. String indicating the location of the expression for error + # reporting, e.g. a file name and a position in the file. + "title": "A String", # Optional. Title for the expression, i.e. a short string describing + # its purpose. This can be used e.g. in UIs which allow to enter the + # expression. + }, + ], + "fingerprint": "A String", # A fingerprint for the Named Set being applied to this Router, which is + # essentially a hash of the Named Set used for optimistic locking. + # The fingerprint is initially generated by Compute Engine and changes + # after every request to modify or update the Named Set. You must always + # provide an up-to-date fingerprint hash in order to update or change + # labels. + # + # To see the latest fingerprint, make a getNamedSet() request + # to retrieve a Named Set. + "name": "A String", # This set's name, which must be a resource ID segment and unique within all + # named sets owned by the Router. Name should conform to RFC1035. + "type": "A String", # This named set's type + }, +}
+
+ +
+ getNatIpInfo(project, region, router, natName=None, x__xgafv=None) +
Retrieves runtime NAT IP information.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  router: string, Name of the Router resource to query for Nat IP information. The name
+should conform to RFC1035. (required)
+  natName: string, Name of the nat service to filter the NAT IP information.
+If it is omitted, all nats for this router will be returned.
+Name should conform to RFC1035.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "result": [ # [Output Only] A list of NAT IP information.
+    { # Contains NAT IP information of a NAT config (i.e. usage status, mode).
+      "natIpInfoMappings": [ # Output only. A list of all NAT IPs assigned to this NAT config.
+        { # Contains information of a NAT IP.
+          "mode": "A String", # Output only. Specifies whether NAT IP is auto or manual.
+          "natIp": "A String", # Output only. NAT IP address. For example: 203.0.113.11.
+          "usage": "A String", # Output only. Specifies whether NAT IP is currently serving at least one endpoint or
+              # not.
+        },
+      ],
+      "natName": "A String", # Output only. Name of the NAT config which the NAT IP belongs to.
+    },
+  ],
 }
@@ -4684,8 +5066,8 @@

Method Details

- listRoutePolicies(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None) -
Retrieves a list of router route policy subresources available to the
+    listNamedSets(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
+  
Retrieves a list of router named set subresources available to the
 specified project.
 
 Args:
@@ -4788,121 +5170,71 @@ 

Method Details

"etag": "A String", "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is # defined by the server. - "kind": "compute#routersListRoutePolicies", # Output only. [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies. + "kind": "compute#routersListNamedSets", # Output only. [Output Only] Type of resource. Alwayscompute#routersListNamedSets for lists of named sets. "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for # the query parameter pageToken in the next list request. # Subsequent list requests will have their own nextPageToken to # continue paging through the results. - "result": [ # [Output Only] A list of route policies. + "result": [ # [Output Only] A list of named sets. { - "description": "A String", # An optional description of route policy. - "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is - # essentially a hash of the Route Policy used for optimistic locking. + "description": "A String", # An optional description of named set. + "elements": [ # CEL expressions that are comparable to constructs of this set's type + # (see Policy Language). + { # Represents a textual expression in the Common Expression Language (CEL) + # syntax. CEL is a C-like expression language. The syntax and semantics of CEL + # are documented at https://github.com/google/cel-spec. + # + # Example (Comparison): + # + # title: "Summary size limit" + # description: "Determines if a summary is less than 100 chars" + # expression: "document.summary.size() < 100" + # + # Example (Equality): + # + # title: "Requestor is owner" + # description: "Determines if requestor is the document owner" + # expression: "document.owner == request.auth.claims.email" + # + # Example (Logic): + # + # title: "Public documents" + # description: "Determine whether the document should be publicly visible" + # expression: "document.type != 'private' && document.type != 'internal'" + # + # Example (Data Manipulation): + # + # title: "Notification string" + # description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" + # + # The exact variables and functions that may be referenced within an expression + # are determined by the service that evaluates it. See the service + # documentation for additional information. + "description": "A String", # Optional. Description of the expression. This is a longer text which + # describes the expression, e.g. when hovered over it in a UI. + "expression": "A String", # Textual representation of an expression in Common Expression Language + # syntax. + "location": "A String", # Optional. String indicating the location of the expression for error + # reporting, e.g. a file name and a position in the file. + "title": "A String", # Optional. Title for the expression, i.e. a short string describing + # its purpose. This can be used e.g. in UIs which allow to enter the + # expression. + }, + ], + "fingerprint": "A String", # A fingerprint for the Named Set being applied to this Router, which is + # essentially a hash of the Named Set used for optimistic locking. # The fingerprint is initially generated by Compute Engine and changes - # after every request to modify or update Route Policy. You must always + # after every request to modify or update the Named Set. You must always # provide an up-to-date fingerprint hash in order to update or change # labels. # - # To see the latest fingerprint, make a getRoutePolicy() request - # to retrieve a Route Policy. - "name": "A String", # Route Policy name, which must be a resource ID segment and unique - # within all the router's Route Policies. Name should conform to RFC1035. - "terms": [ # List of terms (the order in the list is not important, they are evaluated - # in order of priority). Order of policies is not retained and might change - # when getting policy later. - { - "actions": [ # CEL expressions to evaluate to modify a route when this term matches. - { # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # - # Example (Comparison): - # - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # - # Example (Equality): - # - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # - # Example (Logic): - # - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # - # Example (Data Manipulation): - # - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. - "description": "A String", # Optional. Description of the expression. This is a longer text which - # describes the expression, e.g. when hovered over it in a UI. - "expression": "A String", # Textual representation of an expression in Common Expression Language - # syntax. - "location": "A String", # Optional. String indicating the location of the expression for error - # reporting, e.g. a file name and a position in the file. - "title": "A String", # Optional. Title for the expression, i.e. a short string describing - # its purpose. This can be used e.g. in UIs which allow to enter the - # expression. - }, - ], - "match": { # Represents a textual expression in the Common Expression Language (CEL) # CEL expression evaluated against a route to determine if this term - # applies. When not set, the term applies to all - # routes. - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # - # Example (Comparison): - # - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # - # Example (Equality): - # - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # - # Example (Logic): - # - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # - # Example (Data Manipulation): - # - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. - "description": "A String", # Optional. Description of the expression. This is a longer text which - # describes the expression, e.g. when hovered over it in a UI. - "expression": "A String", # Textual representation of an expression in Common Expression Language - # syntax. - "location": "A String", # Optional. String indicating the location of the expression for error - # reporting, e.g. a file name and a position in the file. - "title": "A String", # Optional. Title for the expression, i.e. a short string describing - # its purpose. This can be used e.g. in UIs which allow to enter the - # expression. - }, - "priority": 42, # The evaluation priority for this term, which must be between 0 - # (inclusive) and 2^31 (exclusive), and unique within the list. - }, - ], - "type": "A String", + # To see the latest fingerprint, make a getNamedSet() request + # to retrieve a Named Set. + "name": "A String", # This set's name, which must be a resource ID segment and unique within all + # named sets owned by the Router. Name should conform to RFC1035. + "type": "A String", # This named set's type }, ], "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource. @@ -4938,21 +5270,7 @@

Method Details

- listRoutePolicies_next() -
Retrieves the next page of results.
-
-        Args:
-          previous_request: The request for the previous page. (required)
-          previous_response: The response from the request for the previous page. (required)
-
-        Returns:
-          A request object that you can call 'execute()' on to request the next
-          page. Returns None if there are no more items in the collection.
-        
-
- -
- list_next() + listNamedSets_next()
Retrieves the next page of results.
 
         Args:
@@ -4966,395 +5284,677 @@ 

Method Details

- patch(project, region, router, body=None, requestId=None, x__xgafv=None) -
Patches the specified Router resource with the data included in the
-request. This method supportsPATCH
-semantics and usesJSON merge
-patch format and processing rules.
+    listRoutePolicies(project, region, router, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
+  
Retrieves a list of router route policy subresources available to the
+specified project.
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region for this request. (required)
-  router: string, Name of the Router resource to patch. (required)
-  body: object, The request body.
-    The object takes the form of:
+  router: string, Name or id of the resource for this request.
+Name should conform to RFC1035. (required)
+  filter: string, A filter expression that filters resources listed in the response. Most
+Compute resources support two types of filter expressions:
+expressions that support regular expressions and expressions that follow
+API improvement proposal AIP-160.
+These two types of filter expressions cannot be mixed in one request.
+
+If you want to use AIP-160, your expression must specify the field name, an
+operator, and the value that you want to use for filtering. The value
+must be a string, a number, or a boolean. The operator
+must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
+
+For example, if you are filtering Compute Engine instances, you can
+exclude instances named `example-instance` by specifying
+`name != example-instance`.
+
+The `:*` comparison can be used to test whether a key has been defined.
+For example, to find all objects with `owner` label use:
+```
+labels.owner:*
+```
+
+You can also filter nested fields. For example, you could specify
+`scheduling.automaticRestart = false` to include instances only
+if they are not scheduled for automatic restarts. You can use filtering
+on nested fields to filter based onresource labels.
+
+To filter on multiple expressions, provide each separate expression within
+parentheses. For example:
+```
+(scheduling.automaticRestart = true)
+(cpuPlatform = "Intel Skylake")
+```
+By default, each expression is an `AND` expression. However, you
+can include `AND` and `OR` expressions explicitly.
+For example:
+```
+(cpuPlatform = "Intel Skylake") OR
+(cpuPlatform = "Intel Broadwell") AND
+(scheduling.automaticRestart = true)
+```
+
+If you want to use a regular expression, use the `eq` (equal) or `ne`
+(not equal) operator against a single un-parenthesized expression with or
+without quotes or against multiple parenthesized expressions. Examples:
+
+`fieldname eq unquoted literal`
+`fieldname eq 'single quoted literal'`
+`fieldname eq "double quoted literal"`
+`(fieldname1 eq literal) (fieldname2 ne "literal")`
+
+The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
+The literal value must match the entire field.
+
+For example, to filter for instances that do not end with name "instance",
+you would use `name ne .*instance`.
+
+You cannot combine constraints on multiple fields using regular
+expressions.
+  maxResults: integer, The maximum number of results per page that should be returned.
+If the number of available results is larger than `maxResults`,
+Compute Engine returns a `nextPageToken` that can be used to get
+the next page of results in subsequent list requests. Acceptable values are
+`0` to `500`, inclusive. (Default: `500`)
+  orderBy: string, Sorts list results by a certain order. By default, results
+are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation
+timestamp using `orderBy="creationTimestamp desc"`. This sorts
+results based on the `creationTimestamp` field in
+reverse chronological order (newest result first). Use this to sort
+resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by `name` or
+`creationTimestamp desc` is supported.
+  pageToken: string, Specifies a page token to use. Set `pageToken` to the
+`nextPageToken` returned by a previous list request to get
+the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
+of failure. The default value is false.
+
+For example, when partial success behavior is enabled, aggregatedList for a
+single zone scope either returns all resources in the zone or no resources,
+with an error code.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
 
-{ # Represents a Cloud Router resource.
-    # 
-    # For more information about Cloud Router, read theCloud
-    # Router overview.
-  "bgp": { # BGP information specific to this router.
-    "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
-        # The options are DEFAULT or CUSTOM.
-    "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode.
-        # This field can only be populated if advertise_mode is CUSTOM and
-        # is advertised to all peers of the router.
-        # These groups will be advertised in addition to any specified prefixes.
-        # Leave this field blank to advertise no custom groups.
-      "A String",
-    ],
-    "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
-        # This field can only be populated if advertise_mode is CUSTOM and
-        # is advertised to all peers of the router.
-        # These IP ranges will be advertised in addition to any specified groups.
-        # Leave this field blank to advertise no custom IP ranges.
-      { # Description-tagged IP ranges for the router to advertise.
-        "description": "A String", # User-specified description for the IP range.
-        "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
-      },
-    ],
-    "asn": 42, # Local BGP Autonomous System Number (ASN).
-        # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The
-        # value will be fixed for this router resource. All VPN tunnels that link
-        # to this router will have the same local ASN.
-    "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It
-        # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at
-        # least /30, even if the BGP sessions are over IPv6. It must not overlap
-        # with any IPv4 BGP session ranges.
-        #
-        #
-        # Other vendors commonly call this "router ID".
-    "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are
-        # sent to the peer.
-        #
-        #
-        # Hold time is three times the interval at which keepalive messages are
-        # sent, and the hold time is the maximum number of seconds allowed to
-        # elapse between successive keepalive messages that BGP receives from a
-        # peer.
-        #
-        #
-        # BGP will use the smaller of either the local hold time value or the
-        # peer's hold time value as the hold time for the BGP connection between
-        # the two peers.
-        #
-        #
-        # If set, this value must be between 20 and 60. The default is 20.
-  },
-  "bgpPeers": [ # BGP information that must be configured into the routing stack to
-      # establish BGP peering. This information must specify the peer ASN and
-      # either the interface name, IP address, or peer IP address. Please refer toRFC4273.
     {
-      "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
-      "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode,
-          # which currently supports the following option:
-          #
-          #    - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This
-          #    excludes any routes learned for subnets that use
-          #    VPC Network Peering.
-          #
+  "etag": "A String",
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#routersListRoutePolicies", # Output only. [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies.
+  "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for
+      # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
+      # the query parameter pageToken in the next list request.
+      # Subsequent list requests will have their own nextPageToken to
+      # continue paging through the results.
+  "result": [ # [Output Only] A list of route policies.
+    {
+      "description": "A String", # An optional description of route policy.
+      "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is
+          # essentially a hash of the Route Policy used for optimistic locking.
+          # The fingerprint is initially generated by Compute Engine and changes
+          # after every request to modify or update Route Policy. You must always
+          # provide an up-to-date fingerprint hash in order to update or change
+          # labels.
           #
-          # Note that this field can only be populated if advertise_mode is CUSTOM
-          # and overrides the list defined for the router (in the "bgp" message).
-          # These groups are advertised in addition to any specified prefixes.
-          # Leave this field blank to advertise no custom groups.
-        "A String",
-      ],
-      "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
-          # This field can only be populated if advertise_mode is CUSTOM and
-          # overrides the list defined for the router (in the "bgp" message).
-          # These IP ranges are advertised in addition to any specified groups.
-          # Leave this field blank to advertise no custom IP ranges.
-        { # Description-tagged IP ranges for the router to advertise.
-          "description": "A String", # User-specified description for the IP range.
-          "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
-        },
-      ],
-      "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more
-          # than one matching route of maximum length, the routes with the lowest
-          # priority value win.
-      "bfd": { # BFD configuration for the BGP peering.
-        "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
-            # received from the peer router. The actual value is negotiated between
-            # the two routers and is equal to the greater of this value and the
-            # transmit interval of the other router.
-            #
-            #
-            # If set, this value must be between 1000 and 30000.
-            #
-            #
-            # The default is 1000.
-        "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
-            # transmitted to the peer router. The actual value is negotiated between
-            # the two routers and is equal to the greater of this value and the
-            # corresponding receive interval of the other router.
-            #
-            #
-            # If set, this value must be between 1000 and 30000.
-            #
-            #
-            # The default is 1000.
-        "multiplier": 42, # The number of consecutive BFD packets that must be missed
-            # before BFD declares that a peer is unavailable.
-            #
-            #
-            # If set, the value must be a value between 5 and 16.
-            #
-            #
-            # The default is 5.
-        "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer.
-            #
-            #
-            # If set to ACTIVE, the Cloud Router will initiate the BFD session for
-            # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the
-            # peer router to initiate the BFD session for this BGP peer. If set to
-            # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
-      },
-      "customLearnedIpRanges": [ # A list of user-defined custom learned route IP address ranges for a BGP
-          # session.
+          # To see the latest fingerprint, make a getRoutePolicy() request
+          # to retrieve a Route Policy.
+      "name": "A String", # Route Policy name, which must be a resource ID segment and unique
+          # within all the router's Route Policies. Name should conform to RFC1035.
+      "terms": [ # List of terms (the order in the list is not important, they are evaluated
+          # in order of priority). Order of policies is not retained and might change
+          # when getting policy later.
         {
-          "range": "A String", # The custom learned route IP address range. Must be a valid
-              # CIDR-formatted prefix. If an IP address is provided without a subnet
-              # mask, it is interpreted as, for IPv4, a `/32` singular IP address
-              # range, and, for IPv6, `/128`.
-        },
-      ],
-      "customLearnedRoutePriority": 42, # The user-defined custom learned route priority for a BGP session. This
-          # value is applied to all custom learned route ranges for the session.
-          # You can choose a value from `0` to `65335`. If you don't provide a
-          # value, Google Cloud assigns a priority of `100` to the ranges.
-      "enable": "A String", # The status of the BGP peer connection.
-          #
-          #
-          # If set to FALSE, any active session with the peer is terminated and
-          # all associated routing information is removed. If set to TRUE, the
-          # peer connection can be established with routing information. The default
-          # is TRUE.
-      "enableIpv4": True or False, # Enable IPv4 traffic over BGP Peer. It is enabled by default if
-          # the peerIpAddress is version 4.
-      "enableIpv6": True or False, # Enable IPv6 traffic over BGP Peer. It is enabled by default if the
-          # peerIpAddress is version 6.
-      "exportPolicies": [ # List of export policies applied to this peer, in the order they must be
-          # evaluated. The name must correspond to an existing policy that has
-          # ROUTE_POLICY_TYPE_EXPORT type.
-        "A String",
-      ],
-      "importPolicies": [ # List of import policies applied to this peer, in the order they must be
-          # evaluated. The name must correspond to an existing policy that has
-          # ROUTE_POLICY_TYPE_IMPORT type.
-        "A String",
+          "actions": [ # CEL expressions to evaluate to modify a route when this term matches.
+            { # Represents a textual expression in the Common Expression Language (CEL)
+                # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+                # are documented at https://github.com/google/cel-spec.
+                #
+                # Example (Comparison):
+                #
+                #     title: "Summary size limit"
+                #     description: "Determines if a summary is less than 100 chars"
+                #     expression: "document.summary.size() < 100"
+                #
+                # Example (Equality):
+                #
+                #     title: "Requestor is owner"
+                #     description: "Determines if requestor is the document owner"
+                #     expression: "document.owner == request.auth.claims.email"
+                #
+                # Example (Logic):
+                #
+                #     title: "Public documents"
+                #     description: "Determine whether the document should be publicly visible"
+                #     expression: "document.type != 'private' && document.type != 'internal'"
+                #
+                # Example (Data Manipulation):
+                #
+                #     title: "Notification string"
+                #     description: "Create a notification string with a timestamp."
+                #     expression: "'New message received at ' + string(document.create_time)"
+                #
+                # The exact variables and functions that may be referenced within an expression
+                # are determined by the service that evaluates it. See the service
+                # documentation for additional information.
+              "description": "A String", # Optional. Description of the expression. This is a longer text which
+                  # describes the expression, e.g. when hovered over it in a UI.
+              "expression": "A String", # Textual representation of an expression in Common Expression Language
+                  # syntax.
+              "location": "A String", # Optional. String indicating the location of the expression for error
+                  # reporting, e.g. a file name and a position in the file.
+              "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+                  # its purpose. This can be used e.g. in UIs which allow to enter the
+                  # expression.
+            },
+          ],
+          "match": { # Represents a textual expression in the Common Expression Language (CEL) # CEL expression evaluated against a route to determine if this term
+              # applies. When not set, the term applies to all
+              # routes.
+              # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+              # are documented at https://github.com/google/cel-spec.
+              #
+              # Example (Comparison):
+              #
+              #     title: "Summary size limit"
+              #     description: "Determines if a summary is less than 100 chars"
+              #     expression: "document.summary.size() < 100"
+              #
+              # Example (Equality):
+              #
+              #     title: "Requestor is owner"
+              #     description: "Determines if requestor is the document owner"
+              #     expression: "document.owner == request.auth.claims.email"
+              #
+              # Example (Logic):
+              #
+              #     title: "Public documents"
+              #     description: "Determine whether the document should be publicly visible"
+              #     expression: "document.type != 'private' && document.type != 'internal'"
+              #
+              # Example (Data Manipulation):
+              #
+              #     title: "Notification string"
+              #     description: "Create a notification string with a timestamp."
+              #     expression: "'New message received at ' + string(document.create_time)"
+              #
+              # The exact variables and functions that may be referenced within an expression
+              # are determined by the service that evaluates it. See the service
+              # documentation for additional information.
+            "description": "A String", # Optional. Description of the expression. This is a longer text which
+                # describes the expression, e.g. when hovered over it in a UI.
+            "expression": "A String", # Textual representation of an expression in Common Expression Language
+                # syntax.
+            "location": "A String", # Optional. String indicating the location of the expression for error
+                # reporting, e.g. a file name and a position in the file.
+            "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+                # its purpose. This can be used e.g. in UIs which allow to enter the
+                # expression.
+          },
+          "priority": 42, # The evaluation priority for this term, which must be between 0
+              # (inclusive) and 2^31 (exclusive), and unique within the list.
+        },
       ],
-      "interfaceName": "A String", # Name of the interface the BGP peer is associated with.
-      "ipAddress": "A String", # IP address of the interface inside Google Cloud Platform.
-      "ipv4NexthopAddress": "A String", # IPv4 address of the interface inside Google Cloud Platform.
-      "ipv6NexthopAddress": "A String", # IPv6 address of the interface inside Google Cloud Platform.
-      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this BGP peer.
-          #
-          #    -  MANAGED_BY_USER is the default value and can be managed by you
-          #    or other users
-          #    - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed
-          #    by Cloud Interconnect, specifically by an InterconnectAttachment of type
-          #    PARTNER. Google automatically creates, updates, and deletes this type of
-          #    BGP peer when the PARTNER InterconnectAttachment is created, updated,
-          #    or deleted.
-      "md5AuthenticationKeyName": "A String", # Present if MD5 authentication is enabled for the peering. Must be the
-          # name of one of the entries in the Router.md5_authentication_keys. The
-          # field must comply with RFC1035.
-      "name": "A String", # Name of this BGP peer.
-          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
-          # characters long and match the regular expression
-          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
-          # lowercase letter, and all following characters must be a dash, lowercase
-          # letter, or digit, except the last character, which cannot be a dash.
-      "peerAsn": 42, # Peer BGP Autonomous System Number (ASN). Each BGP interface may use
-          # a different value.
-      "peerIpAddress": "A String", # IP address of the BGP interface outside Google Cloud Platform.
-      "peerIpv4NexthopAddress": "A String", # IPv4 address of the BGP interface outside Google Cloud Platform.
-      "peerIpv6NexthopAddress": "A String", # IPv6 address of the BGP interface outside Google Cloud Platform.
-      "routerApplianceInstance": "A String", # URI of the VM instance that is used as third-party router
-          # appliances such as Next Gen Firewalls, Virtual Routers, or Router
-          # Appliances. The VM instance must be located in zones contained in the
-          # same region as this Cloud Router.
-          # The VM instance is the peer side of the BGP session.
-    },
-  ],
-  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
-      # text format.
-  "description": "A String", # An optional description of this resource. Provide this property when you
-      # create the resource.
-  "encryptedInterconnectRouter": True or False, # Indicates if a router is dedicated for use with encrypted VLAN
-      # attachments (interconnectAttachments).
-  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
-      # defined by the server.
-  "interfaces": [ # Router interfaces.
-      # To create a BGP peer that uses a router interface,
-      # the interface must have one of the following fields specified:
-      # 
-      #    - linkedVpnTunnel
-      #    - linkedInterconnectAttachment
-      #    - subnetwork
-      # 
-      # 
-      # You can create a router interface without any of these fields specified.
-      # However, you cannot create a BGP peer that uses that interface.
-    {
-      "ipRange": "A String", # IP address and range of the interface.
-          #
-          #    - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must
-          #    be a CIDR-formatted string, for example, 169.254.0.1/30.
-          #    Note: Do not truncate the IP address, as it represents the IP address of
-          #    the interface.
-          #    - For Internet Protocol version 6 (IPv6), the value
-          #    must be a unique local address (ULA) range from fdff:1::/64
-          #    with a mask length of 126 or less. This value should be a CIDR-formatted
-          #    string, for example, fdff:1::1/112. Within the router's
-          #    VPC, this IPv6 prefix will be reserved exclusively for this connection
-          #    and cannot be used for any other purpose.
-      "ipVersion": "A String", # IP version of this interface.
-      "linkedInterconnectAttachment": "A String", # URI of the linked Interconnect attachment. It must be in the same region
-          # as the router. Each interface can have one linked resource, which can be
-          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
-      "linkedVpnTunnel": "A String", # URI of the linked VPN tunnel, which must be in the same region as the
-          # router. Each interface can have one linked resource, which can be
-          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
-      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this interface.
-          #
-          #    - MANAGED_BY_USER is the default value and can be managed directly
-          #    by users.
-          #    - MANAGED_BY_ATTACHMENT is an interface that is configured and
-          #    managed by Cloud Interconnect, specifically, by an InterconnectAttachment
-          #    of type PARTNER. Google automatically creates, updates, and deletes
-          #    this type of interface when the PARTNER InterconnectAttachment is
-          #    created, updated, or deleted.
-      "name": "A String", # Name of this interface entry.
-          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
-          # characters long and match the regular expression
-          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
-          # lowercase letter, and all following characters must be a dash, lowercase
-          # letter, or digit, except the last character, which cannot be a dash.
-      "privateIpAddress": "A String", # The regional private internal IP address that is used to establish
-          # BGP sessions to a VM instance acting as a third-party
-          # Router Appliance, such as a Next Gen Firewall, a Virtual Router, or
-          # an SD-WAN VM.
-      "redundantInterface": "A String", # Name of the interface that will be redundant with the current interface
-          # you are creating. The redundantInterface must belong to the same Cloud
-          # Router as the interface here. To establish the BGP session to a Router
-          # Appliance VM, you must create two BGP peers. The two BGP peers must be
-          # attached to two separate interfaces that are redundant with each other.
-          # The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must
-          # be 1-63 characters long and match the regular expression
-          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
-          # lowercase letter, and all following characters must be a dash, lowercase
-          # letter, or digit, except the last character, which cannot be a dash.
-      "subnetwork": "A String", # The URI of the subnetwork resource that this interface belongs to, which
-          # must be in the same region as the Cloud Router.
-          # When you establish a BGP session to a VM instance using this interface,
-          # the VM instance must belong to the same subnetwork as the subnetwork
-          # specified here.
+      "type": "A String",
     },
   ],
-  "kind": "compute#router", # Output only. [Output Only] Type of resource. Always compute#router for
-      # routers.
-  "md5AuthenticationKeys": [ # Keys used for MD5 authentication.
-    {
-      "key": "A String", # [Input only] Value of the key.
-          #
-          # For patch and update calls, it can be skipped to
-          # copy the value from the previous configuration. This is allowed if the
-          # key with the same name existed before the operation. Maximum length is 80
-          # characters. Can only contain printable ASCII characters.
-      "name": "A String", # Name used to identify the key.
-          #
-          # Must be unique within a router. Must be referenced by exactly
-          # one bgpPeer. Must comply withRFC1035.
-    },
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "unreachables": [ # Output only. [Output Only] Unreachable resources.
+    "A String",
   ],
-  "name": "A String", # Name of the resource. Provided by the client when the resource is created.
-      # The name must be 1-63 characters long, and comply withRFC1035.
-      # Specifically, the name must be 1-63 characters long and match the regular
-      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
-      # character must be a lowercase letter, and all following characters must
-      # be a dash, lowercase letter, or digit, except the last character, which
-      # cannot be a dash.
-  "nats": [ # A list of NAT services created in this router.
-    { # Represents a Nat resource. It enables the VMs within the specified
-        # subnetworks to access Internet without external IP addresses. It specifies
-        # a list of subnetworks (and the ranges within) that want to use NAT.
-        # Customers can also provide the external IPs that would be used for NAT. GCP
-        # would auto-allocate ephemeral IPs if no external IPs are provided.
-      "autoNetworkTier": "A String", # The network tier to use when automatically reserving NAT IP addresses.
-          # Must be one of: PREMIUM, STANDARD.
-          # If not specified, then the current
-          # project-level default tier is used.
-      "drainNatIps": [ # A list of URLs of the IP resources to be drained. These IPs
-          # must be valid static external IPs that have been assigned to the NAT.
-          # These IPs should be used for updating/patching a NAT only.
-        "A String",
-      ],
-      "enableDynamicPortAllocation": True or False, # Enable Dynamic Port Allocation.
-          #
-          #
-          # If not specified, it is disabled by default.
+  "warning": { # [Output Only] Informational warning message.
+    "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+        # Engine returns NO_RESULTS_ON_PAGE if there
+        # are no results in the response.
+    "data": [ # [Output Only] Metadata about this warning in key:
+        # value format. For example:
+        #
+        # "data": [
+        #   {
+        #    "key": "scope",
+        #    "value": "zones/us-east1-d"
+        #   }
+      {
+        "key": "A String", # [Output Only] A key that provides more detail on the warning being
+            # returned. For example, for warnings where there are no results in a list
+            # request for a particular zone, this key might be scope and
+            # the key value might be the zone name. Other examples might be a key
+            # indicating a deprecated resource and a suggested replacement, or a
+            # warning about invalid network settings (for example, if an instance
+            # attempts to perform IP forwarding but is not enabled for IP forwarding).
+        "value": "A String", # [Output Only] A warning data value corresponding to the key.
+      },
+    ],
+    "message": "A String", # [Output Only] A human-readable description of the warning code.
+  },
+}
+
+ +
+ listRoutePolicies_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ patch(project, region, router, body=None, requestId=None, x__xgafv=None) +
Patches the specified Router resource with the data included in the
+request. This method supportsPATCH
+semantics and usesJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  router: string, Name of the Router resource to patch. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud Router resource.
+    # 
+    # For more information about Cloud Router, read theCloud
+    # Router overview.
+  "bgp": { # BGP information specific to this router.
+    "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+        # The options are DEFAULT or CUSTOM.
+    "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These groups will be advertised in addition to any specified prefixes.
+        # Leave this field blank to advertise no custom groups.
+      "A String",
+    ],
+    "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These IP ranges will be advertised in addition to any specified groups.
+        # Leave this field blank to advertise no custom IP ranges.
+      { # Description-tagged IP ranges for the router to advertise.
+        "description": "A String", # User-specified description for the IP range.
+        "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
+      },
+    ],
+    "asn": 42, # Local BGP Autonomous System Number (ASN).
+        # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The
+        # value will be fixed for this router resource. All VPN tunnels that link
+        # to this router will have the same local ASN.
+    "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It
+        # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at
+        # least /30, even if the BGP sessions are over IPv6. It must not overlap
+        # with any IPv4 BGP session ranges.
+        #
+        #
+        # Other vendors commonly call this "router ID".
+    "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are
+        # sent to the peer.
+        #
+        #
+        # Hold time is three times the interval at which keepalive messages are
+        # sent, and the hold time is the maximum number of seconds allowed to
+        # elapse between successive keepalive messages that BGP receives from a
+        # peer.
+        #
+        #
+        # BGP will use the smaller of either the local hold time value or the
+        # peer's hold time value as the hold time for the BGP connection between
+        # the two peers.
+        #
+        #
+        # If set, this value must be between 20 and 60. The default is 20.
+  },
+  "bgpPeers": [ # BGP information that must be configured into the routing stack to
+      # establish BGP peering. This information must specify the peer ASN and
+      # either the interface name, IP address, or peer IP address. Please refer toRFC4273.
+    {
+      "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+      "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode,
+          # which currently supports the following option:
           #
+          #    - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This
+          #    excludes any routes learned for subnets that use
+          #    VPC Network Peering.
           #
-          # If set to true,
           #
-          #    - Dynamic Port Allocation will be enabled on this NAT
-          #    config.
-          #    - enableEndpointIndependentMapping cannot be set to true.
-          #    - If minPorts is set, minPortsPerVm must be set to a
-          #    power of two greater than or equal to 32. If minPortsPerVm is not set, a
-          #    minimum of 32 ports will be allocated to a VM from this NAT
-          #    config.
-      "enableEndpointIndependentMapping": True or False,
-      "endpointTypes": [ # List of NAT-ted endpoint types supported by the Nat Gateway. If the list
-          # is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
+          # Note that this field can only be populated if advertise_mode is CUSTOM
+          # and overrides the list defined for the router (in the "bgp" message).
+          # These groups are advertised in addition to any specified prefixes.
+          # Leave this field blank to advertise no custom groups.
         "A String",
       ],
-      "icmpIdleTimeoutSec": 42, # Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
-      "logConfig": { # Configuration of logging on a NAT. # Configure logging on this NAT.
-        "enable": True or False, # Indicates whether or not to export logs. This is false by default.
-        "filter": "A String", # Specify the desired filtering of logs on this NAT. If unspecified,
-            # logs are exported for all connections handled by this NAT.
-            # This option can take one of the following values:
+      "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+          # This field can only be populated if advertise_mode is CUSTOM and
+          # overrides the list defined for the router (in the "bgp" message).
+          # These IP ranges are advertised in addition to any specified groups.
+          # Leave this field blank to advertise no custom IP ranges.
+        { # Description-tagged IP ranges for the router to advertise.
+          "description": "A String", # User-specified description for the IP range.
+          "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
+        },
+      ],
+      "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more
+          # than one matching route of maximum length, the routes with the lowest
+          # priority value win.
+      "bfd": { # BFD configuration for the BGP peering.
+        "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # received from the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # transmit interval of the other router.
             #
-            #    - ERRORS_ONLY: Export logs only for connection failures.
-            #    - TRANSLATIONS_ONLY: Export logs only for successful
-            #    connections.
-            #    - ALL: Export logs for all connections, successful and
-            #    unsuccessful.
+            #
+            # If set, this value must be between 1000 and 30000.
+            #
+            #
+            # The default is 1000.
+        "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # transmitted to the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # corresponding receive interval of the other router.
+            #
+            #
+            # If set, this value must be between 1000 and 30000.
+            #
+            #
+            # The default is 1000.
+        "multiplier": 42, # The number of consecutive BFD packets that must be missed
+            # before BFD declares that a peer is unavailable.
+            #
+            #
+            # If set, the value must be a value between 5 and 16.
+            #
+            #
+            # The default is 5.
+        "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer.
+            #
+            #
+            # If set to ACTIVE, the Cloud Router will initiate the BFD session for
+            # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the
+            # peer router to initiate the BFD session for this BGP peer. If set to
+            # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
       },
-      "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when
-          # Dynamic Port Allocation is enabled.
-          #
-          #
-          # If Dynamic Port Allocation is not enabled, this field has no effect.
-          #
-          #
-          # If Dynamic Port Allocation is enabled, and this field is set, it must be
-          # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm
-          # is not set.
-          #
-          #
-          # If Dynamic Port Allocation is enabled and this field is not set,
-          # a maximum of 65536 ports will be allocated to a VM from this NAT
-          # config.
-      "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not
-          # set, a default number of ports is allocated to a VM. This is rounded
-          # up to the nearest power of 2. For example, if the value of this field is
-          # 50, at least 64 ports are allocated to a VM.
-      "name": "A String", # Unique name of this Nat service.
-          # The name must be 1-63 characters long and comply withRFC1035.
-      "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64
-          # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is
-          # selected for the SubnetworkIpRangeToNat64Option above.
-        { # Specifies a subnetwork to enable NAT64.
-          "name": "A String", # URL for the subnetwork resource that will use NAT64.
+      "customLearnedIpRanges": [ # A list of user-defined custom learned route IP address ranges for a BGP
+          # session.
+        {
+          "range": "A String", # The custom learned route IP address range. Must be a valid
+              # CIDR-formatted prefix. If an IP address is provided without a subnet
+              # mask, it is interpreted as, for IPv4, a `/32` singular IP address
+              # range, and, for IPv6, `/128`.
         },
       ],
-      "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following
-          # values:
+      "customLearnedRoutePriority": 42, # The user-defined custom learned route priority for a BGP session. This
+          # value is applied to all custom learned route ranges for the session.
+          # You can choose a value from `0` to `65335`. If you don't provide a
+          # value, Google Cloud assigns a priority of `100` to the ranges.
+      "enable": "A String", # The status of the BGP peer connection.
           #
-          #    - MANUAL_ONLY: Uses only Nat IP addresses provided by
-          #    customers. When there are not enough specified Nat IPs, the Nat service
-          #    fails for new VMs.
-          #    - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers
-          #    can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should
-          #    be empty.
-      "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP
-          # addresses must be valid static external IP addresses assigned to the
-          # project.
-        "A String",
+          #
+          # If set to FALSE, any active session with the peer is terminated and
+          # all associated routing information is removed. If set to TRUE, the
+          # peer connection can be established with routing information. The default
+          # is TRUE.
+      "enableIpv4": True or False, # Enable IPv4 traffic over BGP Peer. It is enabled by default if
+          # the peerIpAddress is version 4.
+      "enableIpv6": True or False, # Enable IPv6 traffic over BGP Peer. It is enabled by default if the
+          # peerIpAddress is version 6.
+      "exportPolicies": [ # List of export policies applied to this peer, in the order they must be
+          # evaluated. The name must correspond to an existing policy that has
+          # ROUTE_POLICY_TYPE_EXPORT type.
+        "A String",
+      ],
+      "importPolicies": [ # List of import policies applied to this peer, in the order they must be
+          # evaluated. The name must correspond to an existing policy that has
+          # ROUTE_POLICY_TYPE_IMPORT type.
+        "A String",
+      ],
+      "interfaceName": "A String", # Name of the interface the BGP peer is associated with.
+      "ipAddress": "A String", # IP address of the interface inside Google Cloud Platform.
+      "ipv4NexthopAddress": "A String", # IPv4 address of the interface inside Google Cloud Platform.
+      "ipv6NexthopAddress": "A String", # IPv6 address of the interface inside Google Cloud Platform.
+      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this BGP peer.
+          #
+          #    -  MANAGED_BY_USER is the default value and can be managed by you
+          #    or other users
+          #    - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed
+          #    by Cloud Interconnect, specifically by an InterconnectAttachment of type
+          #    PARTNER. Google automatically creates, updates, and deletes this type of
+          #    BGP peer when the PARTNER InterconnectAttachment is created, updated,
+          #    or deleted.
+      "md5AuthenticationKeyName": "A String", # Present if MD5 authentication is enabled for the peering. Must be the
+          # name of one of the entries in the Router.md5_authentication_keys. The
+          # field must comply with RFC1035.
+      "name": "A String", # Name of this BGP peer.
+          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
+          # characters long and match the regular expression
+          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
+          # lowercase letter, and all following characters must be a dash, lowercase
+          # letter, or digit, except the last character, which cannot be a dash.
+      "peerAsn": 42, # Peer BGP Autonomous System Number (ASN). Each BGP interface may use
+          # a different value.
+      "peerIpAddress": "A String", # IP address of the BGP interface outside Google Cloud Platform.
+      "peerIpv4NexthopAddress": "A String", # IPv4 address of the BGP interface outside Google Cloud Platform.
+      "peerIpv6NexthopAddress": "A String", # IPv6 address of the BGP interface outside Google Cloud Platform.
+      "routerApplianceInstance": "A String", # URI of the VM instance that is used as third-party router
+          # appliances such as Next Gen Firewalls, Virtual Routers, or Router
+          # Appliances. The VM instance must be located in zones contained in the
+          # same region as this Cloud Router.
+          # The VM instance is the peer side of the BGP session.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "encryptedInterconnectRouter": True or False, # Indicates if a router is dedicated for use with encrypted VLAN
+      # attachments (interconnectAttachments).
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interfaces": [ # Router interfaces.
+      # To create a BGP peer that uses a router interface,
+      # the interface must have one of the following fields specified:
+      # 
+      #    - linkedVpnTunnel
+      #    - linkedInterconnectAttachment
+      #    - subnetwork
+      # 
+      # 
+      # You can create a router interface without any of these fields specified.
+      # However, you cannot create a BGP peer that uses that interface.
+    {
+      "ipRange": "A String", # IP address and range of the interface.
+          #
+          #    - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must
+          #    be a CIDR-formatted string, for example, 169.254.0.1/30.
+          #    Note: Do not truncate the IP address, as it represents the IP address of
+          #    the interface.
+          #    - For Internet Protocol version 6 (IPv6), the value
+          #    must be a unique local address (ULA) range from fdff:1::/64
+          #    with a mask length of 126 or less. This value should be a CIDR-formatted
+          #    string, for example, fdff:1::1/112. Within the router's
+          #    VPC, this IPv6 prefix will be reserved exclusively for this connection
+          #    and cannot be used for any other purpose.
+      "ipVersion": "A String", # IP version of this interface.
+      "linkedInterconnectAttachment": "A String", # URI of the linked Interconnect attachment. It must be in the same region
+          # as the router. Each interface can have one linked resource, which can be
+          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
+      "linkedVpnTunnel": "A String", # URI of the linked VPN tunnel, which must be in the same region as the
+          # router. Each interface can have one linked resource, which can be
+          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
+      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this interface.
+          #
+          #    - MANAGED_BY_USER is the default value and can be managed directly
+          #    by users.
+          #    - MANAGED_BY_ATTACHMENT is an interface that is configured and
+          #    managed by Cloud Interconnect, specifically, by an InterconnectAttachment
+          #    of type PARTNER. Google automatically creates, updates, and deletes
+          #    this type of interface when the PARTNER InterconnectAttachment is
+          #    created, updated, or deleted.
+      "name": "A String", # Name of this interface entry.
+          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
+          # characters long and match the regular expression
+          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
+          # lowercase letter, and all following characters must be a dash, lowercase
+          # letter, or digit, except the last character, which cannot be a dash.
+      "privateIpAddress": "A String", # The regional private internal IP address that is used to establish
+          # BGP sessions to a VM instance acting as a third-party
+          # Router Appliance, such as a Next Gen Firewall, a Virtual Router, or
+          # an SD-WAN VM.
+      "redundantInterface": "A String", # Name of the interface that will be redundant with the current interface
+          # you are creating. The redundantInterface must belong to the same Cloud
+          # Router as the interface here. To establish the BGP session to a Router
+          # Appliance VM, you must create two BGP peers. The two BGP peers must be
+          # attached to two separate interfaces that are redundant with each other.
+          # The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must
+          # be 1-63 characters long and match the regular expression
+          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
+          # lowercase letter, and all following characters must be a dash, lowercase
+          # letter, or digit, except the last character, which cannot be a dash.
+      "subnetwork": "A String", # The URI of the subnetwork resource that this interface belongs to, which
+          # must be in the same region as the Cloud Router.
+          # When you establish a BGP session to a VM instance using this interface,
+          # the VM instance must belong to the same subnetwork as the subnetwork
+          # specified here.
+    },
+  ],
+  "kind": "compute#router", # Output only. [Output Only] Type of resource. Always compute#router for
+      # routers.
+  "md5AuthenticationKeys": [ # Keys used for MD5 authentication.
+    {
+      "key": "A String", # [Input only] Value of the key.
+          #
+          # For patch and update calls, it can be skipped to
+          # copy the value from the previous configuration. This is allowed if the
+          # key with the same name existed before the operation. Maximum length is 80
+          # characters. Can only contain printable ASCII characters.
+      "name": "A String", # Name used to identify the key.
+          #
+          # Must be unique within a router. Must be referenced by exactly
+          # one bgpPeer. Must comply withRFC1035.
+    },
+  ],
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created.
+      # The name must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the name must be 1-63 characters long and match the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+      # character must be a lowercase letter, and all following characters must
+      # be a dash, lowercase letter, or digit, except the last character, which
+      # cannot be a dash.
+  "nats": [ # A list of NAT services created in this router.
+    { # Represents a Nat resource. It enables the VMs within the specified
+        # subnetworks to access Internet without external IP addresses. It specifies
+        # a list of subnetworks (and the ranges within) that want to use NAT.
+        # Customers can also provide the external IPs that would be used for NAT. GCP
+        # would auto-allocate ephemeral IPs if no external IPs are provided.
+      "autoNetworkTier": "A String", # The network tier to use when automatically reserving NAT IP addresses.
+          # Must be one of: PREMIUM, STANDARD.
+          # If not specified, then the current
+          # project-level default tier is used.
+      "drainNatIps": [ # A list of URLs of the IP resources to be drained. These IPs
+          # must be valid static external IPs that have been assigned to the NAT.
+          # These IPs should be used for updating/patching a NAT only.
+        "A String",
+      ],
+      "enableDynamicPortAllocation": True or False, # Enable Dynamic Port Allocation.
+          #
+          #
+          # If not specified, it is disabled by default.
+          #
+          #
+          # If set to true,
+          #
+          #    - Dynamic Port Allocation will be enabled on this NAT
+          #    config.
+          #    - enableEndpointIndependentMapping cannot be set to true.
+          #    - If minPorts is set, minPortsPerVm must be set to a
+          #    power of two greater than or equal to 32. If minPortsPerVm is not set, a
+          #    minimum of 32 ports will be allocated to a VM from this NAT
+          #    config.
+      "enableEndpointIndependentMapping": True or False,
+      "endpointTypes": [ # List of NAT-ted endpoint types supported by the Nat Gateway. If the list
+          # is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
+        "A String",
+      ],
+      "icmpIdleTimeoutSec": 42, # Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
+      "logConfig": { # Configuration of logging on a NAT. # Configure logging on this NAT.
+        "enable": True or False, # Indicates whether or not to export logs. This is false by default.
+        "filter": "A String", # Specify the desired filtering of logs on this NAT. If unspecified,
+            # logs are exported for all connections handled by this NAT.
+            # This option can take one of the following values:
+            #
+            #    - ERRORS_ONLY: Export logs only for connection failures.
+            #    - TRANSLATIONS_ONLY: Export logs only for successful
+            #    connections.
+            #    - ALL: Export logs for all connections, successful and
+            #    unsuccessful.
+      },
+      "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when
+          # Dynamic Port Allocation is enabled.
+          #
+          #
+          # If Dynamic Port Allocation is not enabled, this field has no effect.
+          #
+          #
+          # If Dynamic Port Allocation is enabled, and this field is set, it must be
+          # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm
+          # is not set.
+          #
+          #
+          # If Dynamic Port Allocation is enabled and this field is not set,
+          # a maximum of 65536 ports will be allocated to a VM from this NAT
+          # config.
+      "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not
+          # set, a default number of ports is allocated to a VM. This is rounded
+          # up to the nearest power of 2. For example, if the value of this field is
+          # 50, at least 64 ports are allocated to a VM.
+      "name": "A String", # Unique name of this Nat service.
+          # The name must be 1-63 characters long and comply withRFC1035.
+      "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64
+          # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is
+          # selected for the SubnetworkIpRangeToNat64Option above.
+        { # Specifies a subnetwork to enable NAT64.
+          "name": "A String", # URL for the subnetwork resource that will use NAT64.
+        },
+      ],
+      "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following
+          # values:
+          #
+          #    - MANUAL_ONLY: Uses only Nat IP addresses provided by
+          #    customers. When there are not enough specified Nat IPs, the Nat service
+          #    fails for new VMs.
+          #    - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers
+          #    can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should
+          #    be empty.
+      "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP
+          # addresses must be valid static external IP addresses assigned to the
+          # project.
+        "A String",
       ],
       "rules": [ # A list of rules associated with this NAT.
         {
@@ -5764,124 +6364,74 @@ 

Method Details

- patchRoutePolicy(project, region, router, body=None, requestId=None, x__xgafv=None) -
Patches Route Policy
+    patchNamedSet(project, region, router, body=None, requestId=None, x__xgafv=None)
+  
Patches Named Set
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region for this request. (required)
-  router: string, Name of the Router resource where Route Policy is defined. (required)
+  router: string, Name of the Router resource where Named Set is defined. (required)
   body: object, The request body.
     The object takes the form of:
 
 {
-  "description": "A String", # An optional description of route policy.
-  "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is
-      # essentially a hash of the Route Policy used for optimistic locking.
-      # The fingerprint is initially generated by Compute Engine and changes
-      # after every request to modify or update Route Policy. You must always
-      # provide an up-to-date fingerprint hash in order to update or change
-      # labels.
-      # 
-      # To see the latest fingerprint, make a getRoutePolicy() request
-      # to retrieve a Route Policy.
-  "name": "A String", # Route Policy name, which must be a resource ID segment and unique
-      # within all the router's Route Policies. Name should conform to RFC1035.
-  "terms": [ # List of terms (the order in the list is not important, they are evaluated
-      # in order of priority). Order of policies is not retained and might change
-      # when getting policy later.
-    {
-      "actions": [ # CEL expressions to evaluate to modify a route when this term matches.
-        { # Represents a textual expression in the Common Expression Language (CEL)
-            # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
-            # are documented at https://github.com/google/cel-spec.
-            #
-            # Example (Comparison):
-            #
-            #     title: "Summary size limit"
-            #     description: "Determines if a summary is less than 100 chars"
-            #     expression: "document.summary.size() < 100"
-            #
-            # Example (Equality):
-            #
-            #     title: "Requestor is owner"
-            #     description: "Determines if requestor is the document owner"
-            #     expression: "document.owner == request.auth.claims.email"
-            #
-            # Example (Logic):
-            #
-            #     title: "Public documents"
-            #     description: "Determine whether the document should be publicly visible"
-            #     expression: "document.type != 'private' && document.type != 'internal'"
-            #
-            # Example (Data Manipulation):
-            #
-            #     title: "Notification string"
-            #     description: "Create a notification string with a timestamp."
-            #     expression: "'New message received at ' + string(document.create_time)"
-            #
-            # The exact variables and functions that may be referenced within an expression
-            # are determined by the service that evaluates it. See the service
-            # documentation for additional information.
-          "description": "A String", # Optional. Description of the expression. This is a longer text which
-              # describes the expression, e.g. when hovered over it in a UI.
-          "expression": "A String", # Textual representation of an expression in Common Expression Language
-              # syntax.
-          "location": "A String", # Optional. String indicating the location of the expression for error
-              # reporting, e.g. a file name and a position in the file.
-          "title": "A String", # Optional. Title for the expression, i.e. a short string describing
-              # its purpose. This can be used e.g. in UIs which allow to enter the
-              # expression.
-        },
-      ],
-      "match": { # Represents a textual expression in the Common Expression Language (CEL) # CEL expression evaluated against a route to determine if this term
-          # applies. When not set, the term applies to all
-          # routes.
-          # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
-          # are documented at https://github.com/google/cel-spec.
-          #
-          # Example (Comparison):
-          #
-          #     title: "Summary size limit"
-          #     description: "Determines if a summary is less than 100 chars"
-          #     expression: "document.summary.size() < 100"
-          #
-          # Example (Equality):
-          #
-          #     title: "Requestor is owner"
-          #     description: "Determines if requestor is the document owner"
-          #     expression: "document.owner == request.auth.claims.email"
-          #
-          # Example (Logic):
-          #
-          #     title: "Public documents"
-          #     description: "Determine whether the document should be publicly visible"
-          #     expression: "document.type != 'private' && document.type != 'internal'"
-          #
-          # Example (Data Manipulation):
-          #
-          #     title: "Notification string"
-          #     description: "Create a notification string with a timestamp."
-          #     expression: "'New message received at ' + string(document.create_time)"
-          #
-          # The exact variables and functions that may be referenced within an expression
-          # are determined by the service that evaluates it. See the service
-          # documentation for additional information.
-        "description": "A String", # Optional. Description of the expression. This is a longer text which
-            # describes the expression, e.g. when hovered over it in a UI.
-        "expression": "A String", # Textual representation of an expression in Common Expression Language
-            # syntax.
-        "location": "A String", # Optional. String indicating the location of the expression for error
-            # reporting, e.g. a file name and a position in the file.
-        "title": "A String", # Optional. Title for the expression, i.e. a short string describing
-            # its purpose. This can be used e.g. in UIs which allow to enter the
-            # expression.
-      },
-      "priority": 42, # The evaluation priority for this term, which must be between 0
-          # (inclusive) and 2^31 (exclusive), and unique within the list.
+  "description": "A String", # An optional description of named set.
+  "elements": [ # CEL expressions that are comparable to constructs of this set's type
+      # (see Policy Language).
+    { # Represents a textual expression in the Common Expression Language (CEL)
+        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # are documented at https://github.com/google/cel-spec.
+        #
+        # Example (Comparison):
+        #
+        #     title: "Summary size limit"
+        #     description: "Determines if a summary is less than 100 chars"
+        #     expression: "document.summary.size() < 100"
+        #
+        # Example (Equality):
+        #
+        #     title: "Requestor is owner"
+        #     description: "Determines if requestor is the document owner"
+        #     expression: "document.owner == request.auth.claims.email"
+        #
+        # Example (Logic):
+        #
+        #     title: "Public documents"
+        #     description: "Determine whether the document should be publicly visible"
+        #     expression: "document.type != 'private' && document.type != 'internal'"
+        #
+        # Example (Data Manipulation):
+        #
+        #     title: "Notification string"
+        #     description: "Create a notification string with a timestamp."
+        #     expression: "'New message received at ' + string(document.create_time)"
+        #
+        # The exact variables and functions that may be referenced within an expression
+        # are determined by the service that evaluates it. See the service
+        # documentation for additional information.
+      "description": "A String", # Optional. Description of the expression. This is a longer text which
+          # describes the expression, e.g. when hovered over it in a UI.
+      "expression": "A String", # Textual representation of an expression in Common Expression Language
+          # syntax.
+      "location": "A String", # Optional. String indicating the location of the expression for error
+          # reporting, e.g. a file name and a position in the file.
+      "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+          # its purpose. This can be used e.g. in UIs which allow to enter the
+          # expression.
     },
   ],
-  "type": "A String",
+  "fingerprint": "A String", # A fingerprint for the Named Set being applied to this Router, which is
+      # essentially a hash of the Named Set used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes
+      # after every request to modify or update the Named Set. You must always
+      # provide an up-to-date fingerprint hash in order to update or change
+      # labels.
+      # 
+      # To see the latest fingerprint, make a getNamedSet() request
+      # to retrieve a Named Set.
+  "name": "A String", # This set's name, which must be a resource ID segment and unique within all
+      # named sets owned by the Router. Name should conform to RFC1035.
+  "type": "A String", # This named set's type
 }
 
   requestId: string, An optional request ID to identify requests. Specify a unique request ID so
@@ -6158,528 +6708,139 @@ 

Method Details

- preview(project, region, router, body=None, x__xgafv=None) -
Preview fields auto-generated during router create andupdate operations.
-Calling this method does NOT create or update the router.
+    patchRoutePolicy(project, region, router, body=None, requestId=None, x__xgafv=None)
+  
Patches Route Policy
 
 Args:
   project: string, Project ID for this request. (required)
   region: string, Name of the region for this request. (required)
-  router: string, Name of the Router resource to query. (required)
+  router: string, Name of the Router resource where Route Policy is defined. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # Represents a Cloud Router resource.
-    # 
-    # For more information about Cloud Router, read theCloud
-    # Router overview.
-  "bgp": { # BGP information specific to this router.
-    "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
-        # The options are DEFAULT or CUSTOM.
-    "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode.
-        # This field can only be populated if advertise_mode is CUSTOM and
-        # is advertised to all peers of the router.
-        # These groups will be advertised in addition to any specified prefixes.
-        # Leave this field blank to advertise no custom groups.
-      "A String",
-    ],
-    "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
-        # This field can only be populated if advertise_mode is CUSTOM and
-        # is advertised to all peers of the router.
-        # These IP ranges will be advertised in addition to any specified groups.
-        # Leave this field blank to advertise no custom IP ranges.
-      { # Description-tagged IP ranges for the router to advertise.
-        "description": "A String", # User-specified description for the IP range.
-        "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
-      },
-    ],
-    "asn": 42, # Local BGP Autonomous System Number (ASN).
-        # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The
-        # value will be fixed for this router resource. All VPN tunnels that link
-        # to this router will have the same local ASN.
-    "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It
-        # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at
-        # least /30, even if the BGP sessions are over IPv6. It must not overlap
-        # with any IPv4 BGP session ranges.
-        #
-        #
-        # Other vendors commonly call this "router ID".
-    "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are
-        # sent to the peer.
-        #
-        #
-        # Hold time is three times the interval at which keepalive messages are
-        # sent, and the hold time is the maximum number of seconds allowed to
-        # elapse between successive keepalive messages that BGP receives from a
-        # peer.
-        #
-        #
-        # BGP will use the smaller of either the local hold time value or the
-        # peer's hold time value as the hold time for the BGP connection between
-        # the two peers.
-        #
-        #
-        # If set, this value must be between 20 and 60. The default is 20.
-  },
-  "bgpPeers": [ # BGP information that must be configured into the routing stack to
-      # establish BGP peering. This information must specify the peer ASN and
-      # either the interface name, IP address, or peer IP address. Please refer toRFC4273.
+{
+  "description": "A String", # An optional description of route policy.
+  "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is
+      # essentially a hash of the Route Policy used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes
+      # after every request to modify or update Route Policy. You must always
+      # provide an up-to-date fingerprint hash in order to update or change
+      # labels.
+      # 
+      # To see the latest fingerprint, make a getRoutePolicy() request
+      # to retrieve a Route Policy.
+  "name": "A String", # Route Policy name, which must be a resource ID segment and unique
+      # within all the router's Route Policies. Name should conform to RFC1035.
+  "terms": [ # List of terms (the order in the list is not important, they are evaluated
+      # in order of priority). Order of policies is not retained and might change
+      # when getting policy later.
     {
-      "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
-      "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode,
-          # which currently supports the following option:
-          #
-          #    - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This
-          #    excludes any routes learned for subnets that use
-          #    VPC Network Peering.
-          #
-          #
-          # Note that this field can only be populated if advertise_mode is CUSTOM
-          # and overrides the list defined for the router (in the "bgp" message).
-          # These groups are advertised in addition to any specified prefixes.
-          # Leave this field blank to advertise no custom groups.
-        "A String",
-      ],
-      "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
-          # This field can only be populated if advertise_mode is CUSTOM and
-          # overrides the list defined for the router (in the "bgp" message).
-          # These IP ranges are advertised in addition to any specified groups.
-          # Leave this field blank to advertise no custom IP ranges.
-        { # Description-tagged IP ranges for the router to advertise.
-          "description": "A String", # User-specified description for the IP range.
-          "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
-        },
-      ],
-      "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more
-          # than one matching route of maximum length, the routes with the lowest
-          # priority value win.
-      "bfd": { # BFD configuration for the BGP peering.
-        "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
-            # received from the peer router. The actual value is negotiated between
-            # the two routers and is equal to the greater of this value and the
-            # transmit interval of the other router.
-            #
-            #
-            # If set, this value must be between 1000 and 30000.
-            #
-            #
-            # The default is 1000.
-        "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
-            # transmitted to the peer router. The actual value is negotiated between
-            # the two routers and is equal to the greater of this value and the
-            # corresponding receive interval of the other router.
-            #
+      "actions": [ # CEL expressions to evaluate to modify a route when this term matches.
+        { # Represents a textual expression in the Common Expression Language (CEL)
+            # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+            # are documented at https://github.com/google/cel-spec.
             #
-            # If set, this value must be between 1000 and 30000.
+            # Example (Comparison):
             #
+            #     title: "Summary size limit"
+            #     description: "Determines if a summary is less than 100 chars"
+            #     expression: "document.summary.size() < 100"
             #
-            # The default is 1000.
-        "multiplier": 42, # The number of consecutive BFD packets that must be missed
-            # before BFD declares that a peer is unavailable.
+            # Example (Equality):
             #
+            #     title: "Requestor is owner"
+            #     description: "Determines if requestor is the document owner"
+            #     expression: "document.owner == request.auth.claims.email"
             #
-            # If set, the value must be a value between 5 and 16.
+            # Example (Logic):
             #
+            #     title: "Public documents"
+            #     description: "Determine whether the document should be publicly visible"
+            #     expression: "document.type != 'private' && document.type != 'internal'"
             #
-            # The default is 5.
-        "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer.
+            # Example (Data Manipulation):
             #
+            #     title: "Notification string"
+            #     description: "Create a notification string with a timestamp."
+            #     expression: "'New message received at ' + string(document.create_time)"
             #
-            # If set to ACTIVE, the Cloud Router will initiate the BFD session for
-            # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the
-            # peer router to initiate the BFD session for this BGP peer. If set to
-            # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
-      },
-      "customLearnedIpRanges": [ # A list of user-defined custom learned route IP address ranges for a BGP
-          # session.
-        {
-          "range": "A String", # The custom learned route IP address range. Must be a valid
-              # CIDR-formatted prefix. If an IP address is provided without a subnet
-              # mask, it is interpreted as, for IPv4, a `/32` singular IP address
-              # range, and, for IPv6, `/128`.
+            # The exact variables and functions that may be referenced within an expression
+            # are determined by the service that evaluates it. See the service
+            # documentation for additional information.
+          "description": "A String", # Optional. Description of the expression. This is a longer text which
+              # describes the expression, e.g. when hovered over it in a UI.
+          "expression": "A String", # Textual representation of an expression in Common Expression Language
+              # syntax.
+          "location": "A String", # Optional. String indicating the location of the expression for error
+              # reporting, e.g. a file name and a position in the file.
+          "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+              # its purpose. This can be used e.g. in UIs which allow to enter the
+              # expression.
         },
       ],
-      "customLearnedRoutePriority": 42, # The user-defined custom learned route priority for a BGP session. This
-          # value is applied to all custom learned route ranges for the session.
-          # You can choose a value from `0` to `65335`. If you don't provide a
-          # value, Google Cloud assigns a priority of `100` to the ranges.
-      "enable": "A String", # The status of the BGP peer connection.
-          #
-          #
-          # If set to FALSE, any active session with the peer is terminated and
-          # all associated routing information is removed. If set to TRUE, the
-          # peer connection can be established with routing information. The default
-          # is TRUE.
-      "enableIpv4": True or False, # Enable IPv4 traffic over BGP Peer. It is enabled by default if
-          # the peerIpAddress is version 4.
-      "enableIpv6": True or False, # Enable IPv6 traffic over BGP Peer. It is enabled by default if the
-          # peerIpAddress is version 6.
-      "exportPolicies": [ # List of export policies applied to this peer, in the order they must be
-          # evaluated. The name must correspond to an existing policy that has
-          # ROUTE_POLICY_TYPE_EXPORT type.
-        "A String",
-      ],
-      "importPolicies": [ # List of import policies applied to this peer, in the order they must be
-          # evaluated. The name must correspond to an existing policy that has
-          # ROUTE_POLICY_TYPE_IMPORT type.
-        "A String",
-      ],
-      "interfaceName": "A String", # Name of the interface the BGP peer is associated with.
-      "ipAddress": "A String", # IP address of the interface inside Google Cloud Platform.
-      "ipv4NexthopAddress": "A String", # IPv4 address of the interface inside Google Cloud Platform.
-      "ipv6NexthopAddress": "A String", # IPv6 address of the interface inside Google Cloud Platform.
-      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this BGP peer.
-          #
-          #    -  MANAGED_BY_USER is the default value and can be managed by you
-          #    or other users
-          #    - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed
-          #    by Cloud Interconnect, specifically by an InterconnectAttachment of type
-          #    PARTNER. Google automatically creates, updates, and deletes this type of
-          #    BGP peer when the PARTNER InterconnectAttachment is created, updated,
-          #    or deleted.
-      "md5AuthenticationKeyName": "A String", # Present if MD5 authentication is enabled for the peering. Must be the
-          # name of one of the entries in the Router.md5_authentication_keys. The
-          # field must comply with RFC1035.
-      "name": "A String", # Name of this BGP peer.
-          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
-          # characters long and match the regular expression
-          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
-          # lowercase letter, and all following characters must be a dash, lowercase
-          # letter, or digit, except the last character, which cannot be a dash.
-      "peerAsn": 42, # Peer BGP Autonomous System Number (ASN). Each BGP interface may use
-          # a different value.
-      "peerIpAddress": "A String", # IP address of the BGP interface outside Google Cloud Platform.
-      "peerIpv4NexthopAddress": "A String", # IPv4 address of the BGP interface outside Google Cloud Platform.
-      "peerIpv6NexthopAddress": "A String", # IPv6 address of the BGP interface outside Google Cloud Platform.
-      "routerApplianceInstance": "A String", # URI of the VM instance that is used as third-party router
-          # appliances such as Next Gen Firewalls, Virtual Routers, or Router
-          # Appliances. The VM instance must be located in zones contained in the
-          # same region as this Cloud Router.
-          # The VM instance is the peer side of the BGP session.
-    },
-  ],
-  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
-      # text format.
-  "description": "A String", # An optional description of this resource. Provide this property when you
-      # create the resource.
-  "encryptedInterconnectRouter": True or False, # Indicates if a router is dedicated for use with encrypted VLAN
-      # attachments (interconnectAttachments).
-  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
-      # defined by the server.
-  "interfaces": [ # Router interfaces.
-      # To create a BGP peer that uses a router interface,
-      # the interface must have one of the following fields specified:
-      # 
-      #    - linkedVpnTunnel
-      #    - linkedInterconnectAttachment
-      #    - subnetwork
-      # 
-      # 
-      # You can create a router interface without any of these fields specified.
-      # However, you cannot create a BGP peer that uses that interface.
-    {
-      "ipRange": "A String", # IP address and range of the interface.
+      "match": { # Represents a textual expression in the Common Expression Language (CEL) # CEL expression evaluated against a route to determine if this term
+          # applies. When not set, the term applies to all
+          # routes.
+          # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+          # are documented at https://github.com/google/cel-spec.
           #
-          #    - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must
-          #    be a CIDR-formatted string, for example, 169.254.0.1/30.
-          #    Note: Do not truncate the IP address, as it represents the IP address of
-          #    the interface.
-          #    - For Internet Protocol version 6 (IPv6), the value
-          #    must be a unique local address (ULA) range from fdff:1::/64
-          #    with a mask length of 126 or less. This value should be a CIDR-formatted
-          #    string, for example, fdff:1::1/112. Within the router's
-          #    VPC, this IPv6 prefix will be reserved exclusively for this connection
-          #    and cannot be used for any other purpose.
-      "ipVersion": "A String", # IP version of this interface.
-      "linkedInterconnectAttachment": "A String", # URI of the linked Interconnect attachment. It must be in the same region
-          # as the router. Each interface can have one linked resource, which can be
-          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
-      "linkedVpnTunnel": "A String", # URI of the linked VPN tunnel, which must be in the same region as the
-          # router. Each interface can have one linked resource, which can be
-          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
-      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this interface.
+          # Example (Comparison):
           #
-          #    - MANAGED_BY_USER is the default value and can be managed directly
-          #    by users.
-          #    - MANAGED_BY_ATTACHMENT is an interface that is configured and
-          #    managed by Cloud Interconnect, specifically, by an InterconnectAttachment
-          #    of type PARTNER. Google automatically creates, updates, and deletes
-          #    this type of interface when the PARTNER InterconnectAttachment is
-          #    created, updated, or deleted.
-      "name": "A String", # Name of this interface entry.
-          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
-          # characters long and match the regular expression
-          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
-          # lowercase letter, and all following characters must be a dash, lowercase
-          # letter, or digit, except the last character, which cannot be a dash.
-      "privateIpAddress": "A String", # The regional private internal IP address that is used to establish
-          # BGP sessions to a VM instance acting as a third-party
-          # Router Appliance, such as a Next Gen Firewall, a Virtual Router, or
-          # an SD-WAN VM.
-      "redundantInterface": "A String", # Name of the interface that will be redundant with the current interface
-          # you are creating. The redundantInterface must belong to the same Cloud
-          # Router as the interface here. To establish the BGP session to a Router
-          # Appliance VM, you must create two BGP peers. The two BGP peers must be
-          # attached to two separate interfaces that are redundant with each other.
-          # The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must
-          # be 1-63 characters long and match the regular expression
-          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
-          # lowercase letter, and all following characters must be a dash, lowercase
-          # letter, or digit, except the last character, which cannot be a dash.
-      "subnetwork": "A String", # The URI of the subnetwork resource that this interface belongs to, which
-          # must be in the same region as the Cloud Router.
-          # When you establish a BGP session to a VM instance using this interface,
-          # the VM instance must belong to the same subnetwork as the subnetwork
-          # specified here.
-    },
-  ],
-  "kind": "compute#router", # Output only. [Output Only] Type of resource. Always compute#router for
-      # routers.
-  "md5AuthenticationKeys": [ # Keys used for MD5 authentication.
-    {
-      "key": "A String", # [Input only] Value of the key.
+          #     title: "Summary size limit"
+          #     description: "Determines if a summary is less than 100 chars"
+          #     expression: "document.summary.size() < 100"
           #
-          # For patch and update calls, it can be skipped to
-          # copy the value from the previous configuration. This is allowed if the
-          # key with the same name existed before the operation. Maximum length is 80
-          # characters. Can only contain printable ASCII characters.
-      "name": "A String", # Name used to identify the key.
+          # Example (Equality):
           #
-          # Must be unique within a router. Must be referenced by exactly
-          # one bgpPeer. Must comply withRFC1035.
-    },
-  ],
-  "name": "A String", # Name of the resource. Provided by the client when the resource is created.
-      # The name must be 1-63 characters long, and comply withRFC1035.
-      # Specifically, the name must be 1-63 characters long and match the regular
-      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
-      # character must be a lowercase letter, and all following characters must
-      # be a dash, lowercase letter, or digit, except the last character, which
-      # cannot be a dash.
-  "nats": [ # A list of NAT services created in this router.
-    { # Represents a Nat resource. It enables the VMs within the specified
-        # subnetworks to access Internet without external IP addresses. It specifies
-        # a list of subnetworks (and the ranges within) that want to use NAT.
-        # Customers can also provide the external IPs that would be used for NAT. GCP
-        # would auto-allocate ephemeral IPs if no external IPs are provided.
-      "autoNetworkTier": "A String", # The network tier to use when automatically reserving NAT IP addresses.
-          # Must be one of: PREMIUM, STANDARD.
-          # If not specified, then the current
-          # project-level default tier is used.
-      "drainNatIps": [ # A list of URLs of the IP resources to be drained. These IPs
-          # must be valid static external IPs that have been assigned to the NAT.
-          # These IPs should be used for updating/patching a NAT only.
-        "A String",
-      ],
-      "enableDynamicPortAllocation": True or False, # Enable Dynamic Port Allocation.
+          #     title: "Requestor is owner"
+          #     description: "Determines if requestor is the document owner"
+          #     expression: "document.owner == request.auth.claims.email"
           #
+          # Example (Logic):
           #
-          # If not specified, it is disabled by default.
+          #     title: "Public documents"
+          #     description: "Determine whether the document should be publicly visible"
+          #     expression: "document.type != 'private' && document.type != 'internal'"
           #
+          # Example (Data Manipulation):
           #
-          # If set to true,
+          #     title: "Notification string"
+          #     description: "Create a notification string with a timestamp."
+          #     expression: "'New message received at ' + string(document.create_time)"
           #
-          #    - Dynamic Port Allocation will be enabled on this NAT
-          #    config.
-          #    - enableEndpointIndependentMapping cannot be set to true.
-          #    - If minPorts is set, minPortsPerVm must be set to a
-          #    power of two greater than or equal to 32. If minPortsPerVm is not set, a
-          #    minimum of 32 ports will be allocated to a VM from this NAT
-          #    config.
-      "enableEndpointIndependentMapping": True or False,
-      "endpointTypes": [ # List of NAT-ted endpoint types supported by the Nat Gateway. If the list
-          # is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
-        "A String",
-      ],
-      "icmpIdleTimeoutSec": 42, # Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
-      "logConfig": { # Configuration of logging on a NAT. # Configure logging on this NAT.
-        "enable": True or False, # Indicates whether or not to export logs. This is false by default.
-        "filter": "A String", # Specify the desired filtering of logs on this NAT. If unspecified,
-            # logs are exported for all connections handled by this NAT.
-            # This option can take one of the following values:
-            #
-            #    - ERRORS_ONLY: Export logs only for connection failures.
-            #    - TRANSLATIONS_ONLY: Export logs only for successful
-            #    connections.
-            #    - ALL: Export logs for all connections, successful and
-            #    unsuccessful.
+          # The exact variables and functions that may be referenced within an expression
+          # are determined by the service that evaluates it. See the service
+          # documentation for additional information.
+        "description": "A String", # Optional. Description of the expression. This is a longer text which
+            # describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language
+            # syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error
+            # reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+            # its purpose. This can be used e.g. in UIs which allow to enter the
+            # expression.
       },
-      "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when
-          # Dynamic Port Allocation is enabled.
-          #
-          #
-          # If Dynamic Port Allocation is not enabled, this field has no effect.
-          #
-          #
-          # If Dynamic Port Allocation is enabled, and this field is set, it must be
-          # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm
-          # is not set.
-          #
-          #
-          # If Dynamic Port Allocation is enabled and this field is not set,
-          # a maximum of 65536 ports will be allocated to a VM from this NAT
-          # config.
-      "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not
-          # set, a default number of ports is allocated to a VM. This is rounded
-          # up to the nearest power of 2. For example, if the value of this field is
-          # 50, at least 64 ports are allocated to a VM.
-      "name": "A String", # Unique name of this Nat service.
-          # The name must be 1-63 characters long and comply withRFC1035.
-      "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64
-          # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is
-          # selected for the SubnetworkIpRangeToNat64Option above.
-        { # Specifies a subnetwork to enable NAT64.
-          "name": "A String", # URL for the subnetwork resource that will use NAT64.
-        },
-      ],
-      "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following
-          # values:
-          #
-          #    - MANUAL_ONLY: Uses only Nat IP addresses provided by
-          #    customers. When there are not enough specified Nat IPs, the Nat service
-          #    fails for new VMs.
-          #    - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers
-          #    can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should
-          #    be empty.
-      "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP
-          # addresses must be valid static external IP addresses assigned to the
-          # project.
-        "A String",
-      ],
-      "rules": [ # A list of rules associated with this NAT.
-        {
-          "action": { # The action to be enforced for traffic that matches this rule.
-            "sourceNatActiveIps": [ # A list of URLs of the IP resources used for this NAT rule. These IP
-                # addresses must be valid static external IP addresses assigned to the
-                # project.
-                # This field is used for public NAT.
-              "A String",
-            ],
-            "sourceNatActiveRanges": [ # A list of URLs of the subnetworks used as source ranges for this
-                # NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT.
-                # This field is used for private NAT.
-              "A String",
-            ],
-            "sourceNatDrainIps": [ # A list of URLs of the IP resources to be drained. These IPs
-                # must be valid static external IPs that have been assigned to the NAT.
-                # These IPs should be used for updating/patching a NAT rule only.
-                # This field is used for public NAT.
-              "A String",
-            ],
-            "sourceNatDrainRanges": [ # A list of URLs of subnetworks representing source ranges to be
-                # drained. This is only supported on patch/update, and these
-                # subnetworks must have previously been used as active ranges in this
-                # NAT Rule.
-                # This field is used for private NAT.
-              "A String",
-            ],
-          },
-          "description": "A String", # An optional description of this rule.
-          "match": "A String", # CEL expression that specifies the match condition that egress traffic
-              # from a VM is evaluated against. If it evaluates to true, the
-              # corresponding `action` is enforced.
-              #
-              # The following examples are valid match expressions for public NAT:
-              #
-              # `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip,
-              #      '2.2.0.0/16')`
-              #
-              # `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'`
-              #
-              # The following example is a valid match expression for private NAT:
-              #
-              # `nexthop.hub ==
-              # '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`
-          "ruleNumber": 42, # An integer uniquely identifying a rule in the list. The rule number
-              # must be a positive value between 0 and 65000, and
-              # must be unique among rules within a NAT.
-        },
-      ],
-      "sourceSubnetworkIpRangesToNat": "A String", # Specify the Nat option, which can take one of the following values:
-          #
-          #    - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every
-          #    Subnetwork are allowed to Nat.
-          #    - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges
-          #    in every Subnetwork are allowed to Nat.
-          #    - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat
-          #    (specified in the field subnetwork below)
-          #
-          #
-          # The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED.
-          # Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there
-          # should not be any other Router.Nat section in any Router for this network
-          # in this region.
-      "sourceSubnetworkIpRangesToNat64": "A String", # Specify the Nat option for NAT64, which can take one of the following
-          # values:
-          #
-          #    - ALL_IPV6_SUBNETWORKS: All of the IP ranges in
-          #    every Subnetwork are allowed to Nat.
-          #    - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat
-          #    (specified in the field nat64_subnetwork below)
-          #
-          #
-          # The default is NAT64_OPTION_UNSPECIFIED.
-          # Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other
-          # Router.Nat section in this region can also enable NAT64 for any
-          # Subnetworks in this network. Other Router.Nat sections can still be
-          # present to enable NAT44 only.
-      "subnetworks": [ # A list of Subnetwork resources whose traffic should be translated by NAT
-          # Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the
-          # SubnetworkIpRangeToNatOption above.
-        { # Defines the IP ranges that want to use NAT for a subnetwork.
-          "name": "A String", # URL for the subnetwork resource that will use NAT.
-          "secondaryIpRangeNames": [ # A list of the secondary ranges of the Subnetwork that are allowed to
-              # use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES"
-              # is one of the values in source_ip_ranges_to_nat.
-            "A String",
-          ],
-          "sourceIpRangesToNat": [ # Specify the options for NAT ranges in the Subnetwork. All
-              # options of a single value are valid except
-              # NAT_IP_RANGE_OPTION_UNSPECIFIED.
-              # The only valid option with multiple values is: ["PRIMARY_IP_RANGE",
-              # "LIST_OF_SECONDARY_IP_RANGES"]
-              # Default: [ALL_IP_RANGES]
-            "A String",
-          ],
-        },
-      ],
-      "tcpEstablishedIdleTimeoutSec": 42, # Timeout (in seconds) for TCP established connections. Defaults to 1200s
-          # if not set.
-      "tcpTimeWaitTimeoutSec": 42, # Timeout (in seconds) for TCP connections that are in TIME_WAIT state.
-          # Defaults to 120s if not set.
-      "tcpTransitoryIdleTimeoutSec": 42, # Timeout (in seconds) for TCP transitory connections. Defaults to 30s if
-          # not set.
-      "type": "A String", # Indicates whether this NAT is used for public or private IP
-          # translation. If unspecified, it defaults to PUBLIC.
-      "udpIdleTimeoutSec": 42, # Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
+      "priority": 42, # The evaluation priority for this term, which must be between 0
+          # (inclusive) and 2^31 (exclusive), and unique within the list.
     },
   ],
-  "nccGateway": "A String", # URI of the ncc_gateway to which this router associated.
-  "network": "A String", # URI of the network to which this router belongs.
-  "params": { # Additional router parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
-      # as part of resource payload.
-    "resourceManagerTags": { # Tag keys/values directly bound to this resource.
-        # The field is allowed for INSERT
-        # only. The keys/values to set on the resource should be specified in
-        # either ID { : } or Namespaced format
-        # { : }.
-        # For example the following are valid inputs:
-        # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"}
-        # * {"123/environment" : "production", "345/abc" : "xyz"}
-        # Note:
-        # * Invalid combinations of ID & namespaced format is not supported. For
-        #   instance: {"123/environment" : "tagValues/444"} is invalid.
-        # * Inconsistent format is not supported. For instance:
-        #   {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid.
-      "a_key": "A String",
-    },
-  },
-  "region": "A String", # [Output Only] URI of the region where the router resides.
-      # You must specify this field as part of the HTTP request URL. It is
-      # not settable as a field in the request body.
-  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "type": "A String",
 }
 
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -6688,688 +6849,390 @@ 

Method Details

Returns: An object of the form: - { - "resource": { # Represents a Cloud Router resource. # Preview of given router. - # - # For more information about Cloud Router, read theCloud - # Router overview. - "bgp": { # BGP information specific to this router. - "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement. - # The options are DEFAULT or CUSTOM. - "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode. - # This field can only be populated if advertise_mode is CUSTOM and - # is advertised to all peers of the router. - # These groups will be advertised in addition to any specified prefixes. - # Leave this field blank to advertise no custom groups. - "A String", - ], - "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode. - # This field can only be populated if advertise_mode is CUSTOM and - # is advertised to all peers of the router. - # These IP ranges will be advertised in addition to any specified groups. - # Leave this field blank to advertise no custom IP ranges. - { # Description-tagged IP ranges for the router to advertise. - "description": "A String", # User-specified description for the IP range. - "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string. - }, - ], - "asn": 42, # Local BGP Autonomous System Number (ASN). - # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The - # value will be fixed for this router resource. All VPN tunnels that link - # to this router will have the same local ASN. - "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It - # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at - # least /30, even if the BGP sessions are over IPv6. It must not overlap - # with any IPv4 BGP session ranges. - # - # - # Other vendors commonly call this "router ID". - "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are - # sent to the peer. - # - # - # Hold time is three times the interval at which keepalive messages are - # sent, and the hold time is the maximum number of seconds allowed to - # elapse between successive keepalive messages that BGP receives from a - # peer. - # - # - # BGP will use the smaller of either the local hold time value or the - # peer's hold time value as the hold time for the BGP connection between - # the two peers. - # - # - # If set, this value must be between 20 and 60. The default is 20. - }, - "bgpPeers": [ # BGP information that must be configured into the routing stack to - # establish BGP peering. This information must specify the peer ASN and - # either the interface name, IP address, or peer IP address. Please refer toRFC4273. - { - "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement. - "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode, - # which currently supports the following option: - # - # - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This - # excludes any routes learned for subnets that use - # VPC Network Peering. - # - # - # Note that this field can only be populated if advertise_mode is CUSTOM - # and overrides the list defined for the router (in the "bgp" message). - # These groups are advertised in addition to any specified prefixes. - # Leave this field blank to advertise no custom groups. - "A String", - ], - "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode. - # This field can only be populated if advertise_mode is CUSTOM and - # overrides the list defined for the router (in the "bgp" message). - # These IP ranges are advertised in addition to any specified groups. - # Leave this field blank to advertise no custom IP ranges. - { # Description-tagged IP ranges for the router to advertise. - "description": "A String", # User-specified description for the IP range. - "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string. - }, - ], - "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more - # than one matching route of maximum length, the routes with the lowest - # priority value win. - "bfd": { # BFD configuration for the BGP peering. - "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets - # received from the peer router. The actual value is negotiated between - # the two routers and is equal to the greater of this value and the - # transmit interval of the other router. - # - # - # If set, this value must be between 1000 and 30000. - # - # - # The default is 1000. - "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets - # transmitted to the peer router. The actual value is negotiated between - # the two routers and is equal to the greater of this value and the - # corresponding receive interval of the other router. - # - # - # If set, this value must be between 1000 and 30000. - # - # - # The default is 1000. - "multiplier": 42, # The number of consecutive BFD packets that must be missed - # before BFD declares that a peer is unavailable. - # - # - # If set, the value must be a value between 5 and 16. - # - # - # The default is 5. - "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer. - # - # - # If set to ACTIVE, the Cloud Router will initiate the BFD session for - # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the - # peer router to initiate the BFD session for this BGP peer. If set to - # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. - }, - "customLearnedIpRanges": [ # A list of user-defined custom learned route IP address ranges for a BGP - # session. + { # Represents an Operation resource. + # + # Google Compute Engine has three Operation resources: + # + # * [Global](/compute/docs/reference/rest/beta/globalOperations) + # * [Regional](/compute/docs/reference/rest/beta/regionOperations) + # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations) + # + # You can use an operation resource to manage asynchronous API requests. + # For more information, readHandling + # API responses. + # + # Operations can be global, regional or zonal. + # + # - For global operations, use the `globalOperations` + # resource. + # - For regional operations, use the + # `regionOperations` resource. + # - For zonal operations, use + # the `zoneOperations` resource. + # + # + # + # For more information, read + # Global, Regional, and Zonal Resources. + # + # Note that completed Operation resources have a limited + # retention period. + "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. + # Not present otherwise. + "creationTimestamp": "A String", # [Deprecated] This field is deprecated. + "description": "A String", # [Output Only] A textual description of the operation, which is + # set when the operation is created. + "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339 + # text format. + "error": { # [Output Only] If errors are generated during processing of the operation, + # this field will be populated. + "errors": [ # [Output Only] The array of errors encountered while processing this + # operation. + { + "code": "A String", # [Output Only] The error type identifier for this error. + "errorDetails": [ # [Output Only] An optional list of messages that contain the error + # details. There is a set of defined message types to use for providing + # details.The syntax depends on the error code. For example, + # QuotaExceededInfo will have details when the error code is + # QUOTA_EXCEEDED. { - "range": "A String", # The custom learned route IP address range. Must be a valid - # CIDR-formatted prefix. If an IP address is provided without a subnet - # mask, it is interpreted as, for IPv4, a `/32` singular IP address - # range, and, for IPv6, `/128`. + "errorInfo": { # Describes the cause of the error with structured details. + # + # Example of an error when contacting the "pubsub.googleapis.com" API when it + # is not enabled: + # + # { "reason": "API_DISABLED" + # "domain": "googleapis.com" + # "metadata": { + # "resource": "projects/123", + # "service": "pubsub.googleapis.com" + # } + # } + # + # This response indicates that the pubsub.googleapis.com API is not enabled. + # + # Example of an error that is returned when attempting to create a Spanner + # instance in a region that is out of stock: + # + # { "reason": "STOCKOUT" + # "domain": "spanner.googleapis.com", + # "metadata": { + # "availableRegions": "us-central1,us-east2" + # } + # } + "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain + # is typically the registered service name of the tool or product that + # generates the error. Example: "pubsub.googleapis.com". If the error is + # generated by some common infrastructure, the error domain must be a + # globally unique value that identifies the infrastructure. For Google API + # infrastructure, the error domain is "googleapis.com". + "metadatas": { # Additional structured details about this error. + # + # Keys must match a regular expression of `a-z+` but should + # ideally be lowerCamelCase. Also, they must be limited to 64 characters in + # length. When identifying the current value of an exceeded limit, the units + # should be contained in the key, not the value. For example, rather than + # `{"instanceLimit": "100/request"}`, should be returned as, + # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of + # instances that can be created in a single (batch) request. + "a_key": "A String", + }, + "reason": "A String", # The reason of the error. This is a constant value that identifies the + # proximate cause of the error. Error reasons are unique within a particular + # domain of errors. This should be at most 63 characters and match a + # regular expression of `A-Z+[A-Z0-9]`, which represents + # UPPER_SNAKE_CASE. + }, + "help": { # Provides links to documentation or for performing an out of band action. + # + # For example, if a quota check failed with an error indicating the calling + # project hasn't enabled the accessed service, this can contain a URL pointing + # directly to the right place in the developer console to flip the bit. + "links": [ # URL(s) pointing to additional information on handling the current error. + { # Describes a URL link. + "description": "A String", # Describes what the link offers. + "url": "A String", # The URL of the link. + }, + ], + }, + "localizedMessage": { # Provides a localized error message that is safe to return to the user + # which can be attached to an RPC error. + "locale": "A String", # The locale used following the specification defined at + # https://www.rfc-editor.org/rfc/bcp/bcp47.txt. + # Examples are: "en-US", "fr-CH", "es-MX" + "message": "A String", # The localized error message in the above locale. + }, + "quotaInfo": { # Additional details for quota exceeded error for resource quota. + "dimensions": { # The map holding related quota dimensions. + "a_key": "A String", + }, + "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota + # type or metric. + "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type + # or metric. + "limitName": "A String", # The name of the quota limit. + "metricName": "A String", # The Compute Engine quota metric name. + "rolloutStatus": "A String", # Rollout status of the future quota limit. + }, }, ], - "customLearnedRoutePriority": 42, # The user-defined custom learned route priority for a BGP session. This - # value is applied to all custom learned route ranges for the session. - # You can choose a value from `0` to `65335`. If you don't provide a - # value, Google Cloud assigns a priority of `100` to the ranges. - "enable": "A String", # The status of the BGP peer connection. - # - # - # If set to FALSE, any active session with the peer is terminated and - # all associated routing information is removed. If set to TRUE, the - # peer connection can be established with routing information. The default - # is TRUE. - "enableIpv4": True or False, # Enable IPv4 traffic over BGP Peer. It is enabled by default if - # the peerIpAddress is version 4. - "enableIpv6": True or False, # Enable IPv6 traffic over BGP Peer. It is enabled by default if the - # peerIpAddress is version 6. - "exportPolicies": [ # List of export policies applied to this peer, in the order they must be - # evaluated. The name must correspond to an existing policy that has - # ROUTE_POLICY_TYPE_EXPORT type. - "A String", - ], - "importPolicies": [ # List of import policies applied to this peer, in the order they must be - # evaluated. The name must correspond to an existing policy that has - # ROUTE_POLICY_TYPE_IMPORT type. - "A String", - ], - "interfaceName": "A String", # Name of the interface the BGP peer is associated with. - "ipAddress": "A String", # IP address of the interface inside Google Cloud Platform. - "ipv4NexthopAddress": "A String", # IPv4 address of the interface inside Google Cloud Platform. - "ipv6NexthopAddress": "A String", # IPv6 address of the interface inside Google Cloud Platform. - "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this BGP peer. - # - # - MANAGED_BY_USER is the default value and can be managed by you - # or other users - # - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed - # by Cloud Interconnect, specifically by an InterconnectAttachment of type - # PARTNER. Google automatically creates, updates, and deletes this type of - # BGP peer when the PARTNER InterconnectAttachment is created, updated, - # or deleted. - "md5AuthenticationKeyName": "A String", # Present if MD5 authentication is enabled for the peering. Must be the - # name of one of the entries in the Router.md5_authentication_keys. The - # field must comply with RFC1035. - "name": "A String", # Name of this BGP peer. - # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 - # characters long and match the regular expression - # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a - # lowercase letter, and all following characters must be a dash, lowercase - # letter, or digit, except the last character, which cannot be a dash. - "peerAsn": 42, # Peer BGP Autonomous System Number (ASN). Each BGP interface may use - # a different value. - "peerIpAddress": "A String", # IP address of the BGP interface outside Google Cloud Platform. - "peerIpv4NexthopAddress": "A String", # IPv4 address of the BGP interface outside Google Cloud Platform. - "peerIpv6NexthopAddress": "A String", # IPv6 address of the BGP interface outside Google Cloud Platform. - "routerApplianceInstance": "A String", # URI of the VM instance that is used as third-party router - # appliances such as Next Gen Firewalls, Virtual Routers, or Router - # Appliances. The VM instance must be located in zones contained in the - # same region as this Cloud Router. - # The VM instance is the peer side of the BGP session. + "location": "A String", # [Output Only] Indicates the field in the request that caused the error. + # This property is optional. + "message": "A String", # [Output Only] An optional, human-readable error message. }, ], - "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 - # text format. - "description": "A String", # An optional description of this resource. Provide this property when you - # create the resource. - "encryptedInterconnectRouter": True or False, # Indicates if a router is dedicated for use with encrypted VLAN - # attachments (interconnectAttachments). - "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is - # defined by the server. - "interfaces": [ # Router interfaces. - # To create a BGP peer that uses a router interface, - # the interface must have one of the following fields specified: - # - # - linkedVpnTunnel - # - linkedInterconnectAttachment - # - subnetwork - # - # - # You can create a router interface without any of these fields specified. - # However, you cannot create a BGP peer that uses that interface. - { - "ipRange": "A String", # IP address and range of the interface. - # - # - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must - # be a CIDR-formatted string, for example, 169.254.0.1/30. - # Note: Do not truncate the IP address, as it represents the IP address of - # the interface. - # - For Internet Protocol version 6 (IPv6), the value - # must be a unique local address (ULA) range from fdff:1::/64 - # with a mask length of 126 or less. This value should be a CIDR-formatted - # string, for example, fdff:1::1/112. Within the router's - # VPC, this IPv6 prefix will be reserved exclusively for this connection - # and cannot be used for any other purpose. - "ipVersion": "A String", # IP version of this interface. - "linkedInterconnectAttachment": "A String", # URI of the linked Interconnect attachment. It must be in the same region - # as the router. Each interface can have one linked resource, which can be - # a VPN tunnel, an Interconnect attachment, or a subnetwork. - "linkedVpnTunnel": "A String", # URI of the linked VPN tunnel, which must be in the same region as the - # router. Each interface can have one linked resource, which can be - # a VPN tunnel, an Interconnect attachment, or a subnetwork. - "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this interface. + }, + "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error + # message that was returned, such as `NOT FOUND`. + "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error + # status code that was returned. For example, a `404` means the + # resource was not found. + "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is + # defined by the server. + "insertTime": "A String", # [Output Only] The time that this operation was requested. + # This value is inRFC3339 + # text format. + "instancesBulkInsertOperationMetadata": { + "perLocationStatus": { # Status information per location (location name is key). + # Example key: zones/us-central1-a + "a_key": { + "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far. + "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback. + "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an + # error. + "status": "A String", # [Output Only] Creation status of BulkInsert operation - information + # if the flow is rolling forward or rolling back. + "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created. + }, + }, + }, + "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for + # Operation resources. + "name": "A String", # [Output Only] Name of the operation. + "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a + # group of operations results from a `bulkInsert` API request. + "operationType": "A String", # [Output Only] The type of operation, such as `insert`, + # `update`, or `delete`, and so on. + "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. + # There is no requirement that this be linear or support any granularity of + # operations. This should not be used to guess when the operation will be + # complete. This number should monotonically increase as the operation + # progresses. + "region": "A String", # [Output Only] The URL of the region where the operation resides. Only + # applicable when performing regional operations. + "selfLink": "A String", # [Output Only] Server-defined URL for the resource. + "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata, + # this field will contain information on all underlying zonal actions and + # their state. + "clientOperationId": "A String", # [Output Only] The client operation id. + "perLocationOperations": { # [Output Only] Status information per location (location name is key). + # Example key: zones/us-central1-a + "a_key": { + "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is + # populated. + # different programming environments, including REST APIs and RPC APIs. It is + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. # - # - MANAGED_BY_USER is the default value and can be managed directly - # by users. - # - MANAGED_BY_ATTACHMENT is an interface that is configured and - # managed by Cloud Interconnect, specifically, by an InterconnectAttachment - # of type PARTNER. Google automatically creates, updates, and deletes - # this type of interface when the PARTNER InterconnectAttachment is - # created, updated, or deleted. - "name": "A String", # Name of this interface entry. - # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 - # characters long and match the regular expression - # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a - # lowercase letter, and all following characters must be a dash, lowercase - # letter, or digit, except the last character, which cannot be a dash. - "privateIpAddress": "A String", # The regional private internal IP address that is used to establish - # BGP sessions to a VM instance acting as a third-party - # Router Appliance, such as a Next Gen Firewall, a Virtual Router, or - # an SD-WAN VM. - "redundantInterface": "A String", # Name of the interface that will be redundant with the current interface - # you are creating. The redundantInterface must belong to the same Cloud - # Router as the interface here. To establish the BGP session to a Router - # Appliance VM, you must create two BGP peers. The two BGP peers must be - # attached to two separate interfaces that are redundant with each other. - # The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must - # be 1-63 characters long and match the regular expression - # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a - # lowercase letter, and all following characters must be a dash, lowercase - # letter, or digit, except the last character, which cannot be a dash. - "subnetwork": "A String", # The URI of the subnetwork resource that this interface belongs to, which - # must be in the same region as the Cloud Router. - # When you establish a BGP session to a VM instance using this interface, - # the VM instance must belong to the same subnetwork as the subnetwork - # specified here. + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). + "code": 42, # The status code, which should be an enum value of google.rpc.Code. + "details": [ # A list of messages that carry the error details. There is a common set of + # message types for APIs to use. + { + "a_key": "", # Properties of the object. Contains field @type with type URL. + }, + ], + "message": "A String", # A developer-facing error message, which should be in English. Any + # user-facing error message should be localized and sent in the + # google.rpc.Status.details field, or localized by the client. + }, + "state": "A String", # [Output Only] Status of the action, which can be one of the following: + # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. }, + }, + }, + "startTime": "A String", # [Output Only] The time that this operation was started by the server. + # This value is inRFC3339 + # text format. + "status": "A String", # [Output Only] The status of the operation, which can be one of the + # following: + # `PENDING`, `RUNNING`, or `DONE`. + "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the + # operation. + "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation + # of the target resource. + "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For + # operations related to creating a snapshot, this points to the disk + # that the snapshot was created from. + "user": "A String", # [Output Only] User who requested the operation, for example: + # `user@example.com` or + # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. + "warnings": [ # [Output Only] If warning messages are generated during processing of the + # operation, this field will be populated. + { + "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute + # Engine returns NO_RESULTS_ON_PAGE if there + # are no results in the response. + "data": [ # [Output Only] Metadata about this warning in key: + # value format. For example: + # + # "data": [ + # { + # "key": "scope", + # "value": "zones/us-east1-d" + # } + { + "key": "A String", # [Output Only] A key that provides more detail on the warning being + # returned. For example, for warnings where there are no results in a list + # request for a particular zone, this key might be scope and + # the key value might be the zone name. Other examples might be a key + # indicating a deprecated resource and a suggested replacement, or a + # warning about invalid network settings (for example, if an instance + # attempts to perform IP forwarding but is not enabled for IP forwarding). + "value": "A String", # [Output Only] A warning data value corresponding to the key. + }, + ], + "message": "A String", # [Output Only] A human-readable description of the warning code. + }, + ], + "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only + # applicable when performing per-zone operations. +}
+
+ +
+ preview(project, region, router, body=None, x__xgafv=None) +
Preview fields auto-generated during router create andupdate operations.
+Calling this method does NOT create or update the router.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  router: string, Name of the Router resource to query. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud Router resource.
+    # 
+    # For more information about Cloud Router, read theCloud
+    # Router overview.
+  "bgp": { # BGP information specific to this router.
+    "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+        # The options are DEFAULT or CUSTOM.
+    "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These groups will be advertised in addition to any specified prefixes.
+        # Leave this field blank to advertise no custom groups.
+      "A String",
     ],
-    "kind": "compute#router", # Output only. [Output Only] Type of resource. Always compute#router for
-        # routers.
-    "md5AuthenticationKeys": [ # Keys used for MD5 authentication.
-      {
-        "key": "A String", # [Input only] Value of the key.
-            #
-            # For patch and update calls, it can be skipped to
-            # copy the value from the previous configuration. This is allowed if the
-            # key with the same name existed before the operation. Maximum length is 80
-            # characters. Can only contain printable ASCII characters.
-        "name": "A String", # Name used to identify the key.
-            #
-            # Must be unique within a router. Must be referenced by exactly
-            # one bgpPeer. Must comply withRFC1035.
+    "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These IP ranges will be advertised in addition to any specified groups.
+        # Leave this field blank to advertise no custom IP ranges.
+      { # Description-tagged IP ranges for the router to advertise.
+        "description": "A String", # User-specified description for the IP range.
+        "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
       },
     ],
-    "name": "A String", # Name of the resource. Provided by the client when the resource is created.
-        # The name must be 1-63 characters long, and comply withRFC1035.
-        # Specifically, the name must be 1-63 characters long and match the regular
-        # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
-        # character must be a lowercase letter, and all following characters must
-        # be a dash, lowercase letter, or digit, except the last character, which
-        # cannot be a dash.
-    "nats": [ # A list of NAT services created in this router.
-      { # Represents a Nat resource. It enables the VMs within the specified
-          # subnetworks to access Internet without external IP addresses. It specifies
-          # a list of subnetworks (and the ranges within) that want to use NAT.
-          # Customers can also provide the external IPs that would be used for NAT. GCP
-          # would auto-allocate ephemeral IPs if no external IPs are provided.
-        "autoNetworkTier": "A String", # The network tier to use when automatically reserving NAT IP addresses.
-            # Must be one of: PREMIUM, STANDARD.
-            # If not specified, then the current
-            # project-level default tier is used.
-        "drainNatIps": [ # A list of URLs of the IP resources to be drained. These IPs
-            # must be valid static external IPs that have been assigned to the NAT.
-            # These IPs should be used for updating/patching a NAT only.
-          "A String",
-        ],
-        "enableDynamicPortAllocation": True or False, # Enable Dynamic Port Allocation.
-            #
-            #
-            # If not specified, it is disabled by default.
-            #
-            #
-            # If set to true,
-            #
-            #    - Dynamic Port Allocation will be enabled on this NAT
-            #    config.
-            #    - enableEndpointIndependentMapping cannot be set to true.
-            #    - If minPorts is set, minPortsPerVm must be set to a
-            #    power of two greater than or equal to 32. If minPortsPerVm is not set, a
-            #    minimum of 32 ports will be allocated to a VM from this NAT
-            #    config.
-        "enableEndpointIndependentMapping": True or False,
-        "endpointTypes": [ # List of NAT-ted endpoint types supported by the Nat Gateway. If the list
-            # is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
-          "A String",
-        ],
-        "icmpIdleTimeoutSec": 42, # Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
-        "logConfig": { # Configuration of logging on a NAT. # Configure logging on this NAT.
-          "enable": True or False, # Indicates whether or not to export logs. This is false by default.
-          "filter": "A String", # Specify the desired filtering of logs on this NAT. If unspecified,
-              # logs are exported for all connections handled by this NAT.
-              # This option can take one of the following values:
-              #
-              #    - ERRORS_ONLY: Export logs only for connection failures.
-              #    - TRANSLATIONS_ONLY: Export logs only for successful
-              #    connections.
-              #    - ALL: Export logs for all connections, successful and
-              #    unsuccessful.
+    "asn": 42, # Local BGP Autonomous System Number (ASN).
+        # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The
+        # value will be fixed for this router resource. All VPN tunnels that link
+        # to this router will have the same local ASN.
+    "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It
+        # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at
+        # least /30, even if the BGP sessions are over IPv6. It must not overlap
+        # with any IPv4 BGP session ranges.
+        #
+        #
+        # Other vendors commonly call this "router ID".
+    "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are
+        # sent to the peer.
+        #
+        #
+        # Hold time is three times the interval at which keepalive messages are
+        # sent, and the hold time is the maximum number of seconds allowed to
+        # elapse between successive keepalive messages that BGP receives from a
+        # peer.
+        #
+        #
+        # BGP will use the smaller of either the local hold time value or the
+        # peer's hold time value as the hold time for the BGP connection between
+        # the two peers.
+        #
+        #
+        # If set, this value must be between 20 and 60. The default is 20.
+  },
+  "bgpPeers": [ # BGP information that must be configured into the routing stack to
+      # establish BGP peering. This information must specify the peer ASN and
+      # either the interface name, IP address, or peer IP address. Please refer toRFC4273.
+    {
+      "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+      "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode,
+          # which currently supports the following option:
+          #
+          #    - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This
+          #    excludes any routes learned for subnets that use
+          #    VPC Network Peering.
+          #
+          #
+          # Note that this field can only be populated if advertise_mode is CUSTOM
+          # and overrides the list defined for the router (in the "bgp" message).
+          # These groups are advertised in addition to any specified prefixes.
+          # Leave this field blank to advertise no custom groups.
+        "A String",
+      ],
+      "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+          # This field can only be populated if advertise_mode is CUSTOM and
+          # overrides the list defined for the router (in the "bgp" message).
+          # These IP ranges are advertised in addition to any specified groups.
+          # Leave this field blank to advertise no custom IP ranges.
+        { # Description-tagged IP ranges for the router to advertise.
+          "description": "A String", # User-specified description for the IP range.
+          "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
         },
-        "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when
-            # Dynamic Port Allocation is enabled.
+      ],
+      "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more
+          # than one matching route of maximum length, the routes with the lowest
+          # priority value win.
+      "bfd": { # BFD configuration for the BGP peering.
+        "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # received from the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # transmit interval of the other router.
             #
             #
-            # If Dynamic Port Allocation is not enabled, this field has no effect.
+            # If set, this value must be between 1000 and 30000.
             #
             #
-            # If Dynamic Port Allocation is enabled, and this field is set, it must be
-            # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm
-            # is not set.
+            # The default is 1000.
+        "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # transmitted to the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # corresponding receive interval of the other router.
             #
             #
-            # If Dynamic Port Allocation is enabled and this field is not set,
-            # a maximum of 65536 ports will be allocated to a VM from this NAT
-            # config.
-        "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not
-            # set, a default number of ports is allocated to a VM. This is rounded
-            # up to the nearest power of 2. For example, if the value of this field is
-            # 50, at least 64 ports are allocated to a VM.
-        "name": "A String", # Unique name of this Nat service.
-            # The name must be 1-63 characters long and comply withRFC1035.
-        "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64
-            # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is
-            # selected for the SubnetworkIpRangeToNat64Option above.
-          { # Specifies a subnetwork to enable NAT64.
-            "name": "A String", # URL for the subnetwork resource that will use NAT64.
-          },
-        ],
-        "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following
-            # values:
+            # If set, this value must be between 1000 and 30000.
             #
-            #    - MANUAL_ONLY: Uses only Nat IP addresses provided by
-            #    customers. When there are not enough specified Nat IPs, the Nat service
-            #    fails for new VMs.
-            #    - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers
-            #    can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should
-            #    be empty.
-        "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP
-            # addresses must be valid static external IP addresses assigned to the
-            # project.
-          "A String",
-        ],
-        "rules": [ # A list of rules associated with this NAT.
-          {
-            "action": { # The action to be enforced for traffic that matches this rule.
-              "sourceNatActiveIps": [ # A list of URLs of the IP resources used for this NAT rule. These IP
-                  # addresses must be valid static external IP addresses assigned to the
-                  # project.
-                  # This field is used for public NAT.
-                "A String",
-              ],
-              "sourceNatActiveRanges": [ # A list of URLs of the subnetworks used as source ranges for this
-                  # NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT.
-                  # This field is used for private NAT.
-                "A String",
-              ],
-              "sourceNatDrainIps": [ # A list of URLs of the IP resources to be drained. These IPs
-                  # must be valid static external IPs that have been assigned to the NAT.
-                  # These IPs should be used for updating/patching a NAT rule only.
-                  # This field is used for public NAT.
-                "A String",
-              ],
-              "sourceNatDrainRanges": [ # A list of URLs of subnetworks representing source ranges to be
-                  # drained. This is only supported on patch/update, and these
-                  # subnetworks must have previously been used as active ranges in this
-                  # NAT Rule.
-                  # This field is used for private NAT.
-                "A String",
-              ],
-            },
-            "description": "A String", # An optional description of this rule.
-            "match": "A String", # CEL expression that specifies the match condition that egress traffic
-                # from a VM is evaluated against. If it evaluates to true, the
-                # corresponding `action` is enforced.
-                #
-                # The following examples are valid match expressions for public NAT:
-                #
-                # `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip,
-                #      '2.2.0.0/16')`
-                #
-                # `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'`
-                #
-                # The following example is a valid match expression for private NAT:
-                #
-                # `nexthop.hub ==
-                # '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`
-            "ruleNumber": 42, # An integer uniquely identifying a rule in the list. The rule number
-                # must be a positive value between 0 and 65000, and
-                # must be unique among rules within a NAT.
-          },
-        ],
-        "sourceSubnetworkIpRangesToNat": "A String", # Specify the Nat option, which can take one of the following values:
             #
-            #    - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every
-            #    Subnetwork are allowed to Nat.
-            #    - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges
-            #    in every Subnetwork are allowed to Nat.
-            #    - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat
-            #    (specified in the field subnetwork below)
+            # The default is 1000.
+        "multiplier": 42, # The number of consecutive BFD packets that must be missed
+            # before BFD declares that a peer is unavailable.
             #
             #
-            # The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED.
-            # Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there
-            # should not be any other Router.Nat section in any Router for this network
-            # in this region.
-        "sourceSubnetworkIpRangesToNat64": "A String", # Specify the Nat option for NAT64, which can take one of the following
-            # values:
+            # If set, the value must be a value between 5 and 16.
             #
-            #    - ALL_IPV6_SUBNETWORKS: All of the IP ranges in
-            #    every Subnetwork are allowed to Nat.
-            #    - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat
-            #    (specified in the field nat64_subnetwork below)
             #
+            # The default is 5.
+        "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer.
             #
-            # The default is NAT64_OPTION_UNSPECIFIED.
-            # Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other
-            # Router.Nat section in this region can also enable NAT64 for any
-            # Subnetworks in this network. Other Router.Nat sections can still be
-            # present to enable NAT44 only.
-        "subnetworks": [ # A list of Subnetwork resources whose traffic should be translated by NAT
-            # Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the
-            # SubnetworkIpRangeToNatOption above.
-          { # Defines the IP ranges that want to use NAT for a subnetwork.
-            "name": "A String", # URL for the subnetwork resource that will use NAT.
-            "secondaryIpRangeNames": [ # A list of the secondary ranges of the Subnetwork that are allowed to
-                # use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES"
-                # is one of the values in source_ip_ranges_to_nat.
-              "A String",
-            ],
-            "sourceIpRangesToNat": [ # Specify the options for NAT ranges in the Subnetwork. All
-                # options of a single value are valid except
-                # NAT_IP_RANGE_OPTION_UNSPECIFIED.
-                # The only valid option with multiple values is: ["PRIMARY_IP_RANGE",
-                # "LIST_OF_SECONDARY_IP_RANGES"]
-                # Default: [ALL_IP_RANGES]
-              "A String",
-            ],
-          },
-        ],
-        "tcpEstablishedIdleTimeoutSec": 42, # Timeout (in seconds) for TCP established connections. Defaults to 1200s
-            # if not set.
-        "tcpTimeWaitTimeoutSec": 42, # Timeout (in seconds) for TCP connections that are in TIME_WAIT state.
-            # Defaults to 120s if not set.
-        "tcpTransitoryIdleTimeoutSec": 42, # Timeout (in seconds) for TCP transitory connections. Defaults to 30s if
-            # not set.
-        "type": "A String", # Indicates whether this NAT is used for public or private IP
-            # translation. If unspecified, it defaults to PUBLIC.
-        "udpIdleTimeoutSec": 42, # Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
-      },
-    ],
-    "nccGateway": "A String", # URI of the ncc_gateway to which this router associated.
-    "network": "A String", # URI of the network to which this router belongs.
-    "params": { # Additional router parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
-        # as part of resource payload.
-      "resourceManagerTags": { # Tag keys/values directly bound to this resource.
-          # The field is allowed for INSERT
-          # only. The keys/values to set on the resource should be specified in
-          # either ID { : } or Namespaced format
-          # { : }.
-          # For example the following are valid inputs:
-          # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"}
-          # * {"123/environment" : "production", "345/abc" : "xyz"}
-          # Note:
-          # * Invalid combinations of ID & namespaced format is not supported. For
-          #   instance: {"123/environment" : "tagValues/444"} is invalid.
-          # * Inconsistent format is not supported. For instance:
-          #   {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid.
-        "a_key": "A String",
-      },
-    },
-    "region": "A String", # [Output Only] URI of the region where the router resides.
-        # You must specify this field as part of the HTTP request URL. It is
-        # not settable as a field in the request body.
-    "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
-  },
-}
-
- -
- testIamPermissions(project, region, resource, body=None, x__xgafv=None) -
Returns permissions that a caller has on the specified resource.
-
-Args:
-  project: string, Project ID for this request. (required)
-  region: string, The name of the region for this request. (required)
-  resource: string, Name or id of the resource for this request. (required)
-  body: object, The request body.
-    The object takes the form of:
-
-{
-  "permissions": [ # The set of permissions to check for the 'resource'. Permissions with
-      # wildcards (such as '*' or 'storage.*') are not allowed.
-    "A String",
-  ],
-}
-
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    {
-  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
-      # allowed.
-    "A String",
-  ],
-}
-
- -
- update(project, region, router, body=None, requestId=None, x__xgafv=None) -
Updates the specified Router resource with the data included in the
-request.  This method conforms toPUT semantics, which requests that the state of the
-target resource be created or replaced with the state defined by the
-representation enclosed in the request message payload.
-
-Args:
-  project: string, Project ID for this request. (required)
-  region: string, Name of the region for this request. (required)
-  router: string, Name of the Router resource to update. (required)
-  body: object, The request body.
-    The object takes the form of:
-
-{ # Represents a Cloud Router resource.
-    # 
-    # For more information about Cloud Router, read theCloud
-    # Router overview.
-  "bgp": { # BGP information specific to this router.
-    "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
-        # The options are DEFAULT or CUSTOM.
-    "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode.
-        # This field can only be populated if advertise_mode is CUSTOM and
-        # is advertised to all peers of the router.
-        # These groups will be advertised in addition to any specified prefixes.
-        # Leave this field blank to advertise no custom groups.
-      "A String",
-    ],
-    "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
-        # This field can only be populated if advertise_mode is CUSTOM and
-        # is advertised to all peers of the router.
-        # These IP ranges will be advertised in addition to any specified groups.
-        # Leave this field blank to advertise no custom IP ranges.
-      { # Description-tagged IP ranges for the router to advertise.
-        "description": "A String", # User-specified description for the IP range.
-        "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
-      },
-    ],
-    "asn": 42, # Local BGP Autonomous System Number (ASN).
-        # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The
-        # value will be fixed for this router resource. All VPN tunnels that link
-        # to this router will have the same local ASN.
-    "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It
-        # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at
-        # least /30, even if the BGP sessions are over IPv6. It must not overlap
-        # with any IPv4 BGP session ranges.
-        #
-        #
-        # Other vendors commonly call this "router ID".
-    "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are
-        # sent to the peer.
-        #
-        #
-        # Hold time is three times the interval at which keepalive messages are
-        # sent, and the hold time is the maximum number of seconds allowed to
-        # elapse between successive keepalive messages that BGP receives from a
-        # peer.
-        #
-        #
-        # BGP will use the smaller of either the local hold time value or the
-        # peer's hold time value as the hold time for the BGP connection between
-        # the two peers.
-        #
-        #
-        # If set, this value must be between 20 and 60. The default is 20.
-  },
-  "bgpPeers": [ # BGP information that must be configured into the routing stack to
-      # establish BGP peering. This information must specify the peer ASN and
-      # either the interface name, IP address, or peer IP address. Please refer toRFC4273.
-    {
-      "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
-      "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode,
-          # which currently supports the following option:
-          #
-          #    - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This
-          #    excludes any routes learned for subnets that use
-          #    VPC Network Peering.
-          #
-          #
-          # Note that this field can only be populated if advertise_mode is CUSTOM
-          # and overrides the list defined for the router (in the "bgp" message).
-          # These groups are advertised in addition to any specified prefixes.
-          # Leave this field blank to advertise no custom groups.
-        "A String",
-      ],
-      "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
-          # This field can only be populated if advertise_mode is CUSTOM and
-          # overrides the list defined for the router (in the "bgp" message).
-          # These IP ranges are advertised in addition to any specified groups.
-          # Leave this field blank to advertise no custom IP ranges.
-        { # Description-tagged IP ranges for the router to advertise.
-          "description": "A String", # User-specified description for the IP range.
-          "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
-        },
-      ],
-      "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more
-          # than one matching route of maximum length, the routes with the lowest
-          # priority value win.
-      "bfd": { # BFD configuration for the BGP peering.
-        "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
-            # received from the peer router. The actual value is negotiated between
-            # the two routers and is equal to the greater of this value and the
-            # transmit interval of the other router.
-            #
-            #
-            # If set, this value must be between 1000 and 30000.
-            #
-            #
-            # The default is 1000.
-        "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
-            # transmitted to the peer router. The actual value is negotiated between
-            # the two routers and is equal to the greater of this value and the
-            # corresponding receive interval of the other router.
-            #
-            #
-            # If set, this value must be between 1000 and 30000.
-            #
-            #
-            # The default is 1000.
-        "multiplier": 42, # The number of consecutive BFD packets that must be missed
-            # before BFD declares that a peer is unavailable.
-            #
-            #
-            # If set, the value must be a value between 5 and 16.
-            #
-            #
-            # The default is 5.
-        "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer.
-            #
-            #
-            # If set to ACTIVE, the Cloud Router will initiate the BFD session for
-            # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the
-            # peer router to initiate the BFD session for this BGP peer. If set to
-            # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
+            #
+            # If set to ACTIVE, the Cloud Router will initiate the BFD session for
+            # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the
+            # peer router to initiate the BFD session for this BGP peer. If set to
+            # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
       },
       "customLearnedIpRanges": [ # A list of user-defined custom learned route IP address ranges for a BGP
           # session.
@@ -7579,186 +7442,1611 @@ 

Method Details

# logs are exported for all connections handled by this NAT. # This option can take one of the following values: # - # - ERRORS_ONLY: Export logs only for connection failures. - # - TRANSLATIONS_ONLY: Export logs only for successful - # connections. - # - ALL: Export logs for all connections, successful and - # unsuccessful. - }, - "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when - # Dynamic Port Allocation is enabled. - # - # - # If Dynamic Port Allocation is not enabled, this field has no effect. - # - # - # If Dynamic Port Allocation is enabled, and this field is set, it must be - # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm - # is not set. - # - # - # If Dynamic Port Allocation is enabled and this field is not set, - # a maximum of 65536 ports will be allocated to a VM from this NAT - # config. - "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not - # set, a default number of ports is allocated to a VM. This is rounded - # up to the nearest power of 2. For example, if the value of this field is - # 50, at least 64 ports are allocated to a VM. - "name": "A String", # Unique name of this Nat service. - # The name must be 1-63 characters long and comply withRFC1035. - "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64 - # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is - # selected for the SubnetworkIpRangeToNat64Option above. - { # Specifies a subnetwork to enable NAT64. - "name": "A String", # URL for the subnetwork resource that will use NAT64. + # - ERRORS_ONLY: Export logs only for connection failures. + # - TRANSLATIONS_ONLY: Export logs only for successful + # connections. + # - ALL: Export logs for all connections, successful and + # unsuccessful. + }, + "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when + # Dynamic Port Allocation is enabled. + # + # + # If Dynamic Port Allocation is not enabled, this field has no effect. + # + # + # If Dynamic Port Allocation is enabled, and this field is set, it must be + # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm + # is not set. + # + # + # If Dynamic Port Allocation is enabled and this field is not set, + # a maximum of 65536 ports will be allocated to a VM from this NAT + # config. + "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not + # set, a default number of ports is allocated to a VM. This is rounded + # up to the nearest power of 2. For example, if the value of this field is + # 50, at least 64 ports are allocated to a VM. + "name": "A String", # Unique name of this Nat service. + # The name must be 1-63 characters long and comply withRFC1035. + "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64 + # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is + # selected for the SubnetworkIpRangeToNat64Option above. + { # Specifies a subnetwork to enable NAT64. + "name": "A String", # URL for the subnetwork resource that will use NAT64. + }, + ], + "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following + # values: + # + # - MANUAL_ONLY: Uses only Nat IP addresses provided by + # customers. When there are not enough specified Nat IPs, the Nat service + # fails for new VMs. + # - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + # can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should + # be empty. + "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP + # addresses must be valid static external IP addresses assigned to the + # project. + "A String", + ], + "rules": [ # A list of rules associated with this NAT. + { + "action": { # The action to be enforced for traffic that matches this rule. + "sourceNatActiveIps": [ # A list of URLs of the IP resources used for this NAT rule. These IP + # addresses must be valid static external IP addresses assigned to the + # project. + # This field is used for public NAT. + "A String", + ], + "sourceNatActiveRanges": [ # A list of URLs of the subnetworks used as source ranges for this + # NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. + # This field is used for private NAT. + "A String", + ], + "sourceNatDrainIps": [ # A list of URLs of the IP resources to be drained. These IPs + # must be valid static external IPs that have been assigned to the NAT. + # These IPs should be used for updating/patching a NAT rule only. + # This field is used for public NAT. + "A String", + ], + "sourceNatDrainRanges": [ # A list of URLs of subnetworks representing source ranges to be + # drained. This is only supported on patch/update, and these + # subnetworks must have previously been used as active ranges in this + # NAT Rule. + # This field is used for private NAT. + "A String", + ], + }, + "description": "A String", # An optional description of this rule. + "match": "A String", # CEL expression that specifies the match condition that egress traffic + # from a VM is evaluated against. If it evaluates to true, the + # corresponding `action` is enforced. + # + # The following examples are valid match expressions for public NAT: + # + # `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, + # '2.2.0.0/16')` + # + # `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` + # + # The following example is a valid match expression for private NAT: + # + # `nexthop.hub == + # '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` + "ruleNumber": 42, # An integer uniquely identifying a rule in the list. The rule number + # must be a positive value between 0 and 65000, and + # must be unique among rules within a NAT. + }, + ], + "sourceSubnetworkIpRangesToNat": "A String", # Specify the Nat option, which can take one of the following values: + # + # - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + # Subnetwork are allowed to Nat. + # - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + # in every Subnetwork are allowed to Nat. + # - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat + # (specified in the field subnetwork below) + # + # + # The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. + # Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there + # should not be any other Router.Nat section in any Router for this network + # in this region. + "sourceSubnetworkIpRangesToNat64": "A String", # Specify the Nat option for NAT64, which can take one of the following + # values: + # + # - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + # every Subnetwork are allowed to Nat. + # - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + # (specified in the field nat64_subnetwork below) + # + # + # The default is NAT64_OPTION_UNSPECIFIED. + # Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + # Router.Nat section in this region can also enable NAT64 for any + # Subnetworks in this network. Other Router.Nat sections can still be + # present to enable NAT44 only. + "subnetworks": [ # A list of Subnetwork resources whose traffic should be translated by NAT + # Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the + # SubnetworkIpRangeToNatOption above. + { # Defines the IP ranges that want to use NAT for a subnetwork. + "name": "A String", # URL for the subnetwork resource that will use NAT. + "secondaryIpRangeNames": [ # A list of the secondary ranges of the Subnetwork that are allowed to + # use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" + # is one of the values in source_ip_ranges_to_nat. + "A String", + ], + "sourceIpRangesToNat": [ # Specify the options for NAT ranges in the Subnetwork. All + # options of a single value are valid except + # NAT_IP_RANGE_OPTION_UNSPECIFIED. + # The only valid option with multiple values is: ["PRIMARY_IP_RANGE", + # "LIST_OF_SECONDARY_IP_RANGES"] + # Default: [ALL_IP_RANGES] + "A String", + ], + }, + ], + "tcpEstablishedIdleTimeoutSec": 42, # Timeout (in seconds) for TCP established connections. Defaults to 1200s + # if not set. + "tcpTimeWaitTimeoutSec": 42, # Timeout (in seconds) for TCP connections that are in TIME_WAIT state. + # Defaults to 120s if not set. + "tcpTransitoryIdleTimeoutSec": 42, # Timeout (in seconds) for TCP transitory connections. Defaults to 30s if + # not set. + "type": "A String", # Indicates whether this NAT is used for public or private IP + # translation. If unspecified, it defaults to PUBLIC. + "udpIdleTimeoutSec": 42, # Timeout (in seconds) for UDP connections. Defaults to 30s if not set. + }, + ], + "nccGateway": "A String", # URI of the ncc_gateway to which this router associated. + "network": "A String", # URI of the network to which this router belongs. + "params": { # Additional router parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, + "region": "A String", # [Output Only] URI of the region where the router resides. + # You must specify this field as part of the HTTP request URL. It is + # not settable as a field in the request body. + "selfLink": "A String", # [Output Only] Server-defined URL for the resource. +} + + x__xgafv: string, V1 error format. + Allowed values + 1 - v1 error format + 2 - v2 error format + +Returns: + An object of the form: + + { + "resource": { # Represents a Cloud Router resource. # Preview of given router. + # + # For more information about Cloud Router, read theCloud + # Router overview. + "bgp": { # BGP information specific to this router. + "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement. + # The options are DEFAULT or CUSTOM. + "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode. + # This field can only be populated if advertise_mode is CUSTOM and + # is advertised to all peers of the router. + # These groups will be advertised in addition to any specified prefixes. + # Leave this field blank to advertise no custom groups. + "A String", + ], + "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode. + # This field can only be populated if advertise_mode is CUSTOM and + # is advertised to all peers of the router. + # These IP ranges will be advertised in addition to any specified groups. + # Leave this field blank to advertise no custom IP ranges. + { # Description-tagged IP ranges for the router to advertise. + "description": "A String", # User-specified description for the IP range. + "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string. + }, + ], + "asn": 42, # Local BGP Autonomous System Number (ASN). + # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The + # value will be fixed for this router resource. All VPN tunnels that link + # to this router will have the same local ASN. + "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It + # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at + # least /30, even if the BGP sessions are over IPv6. It must not overlap + # with any IPv4 BGP session ranges. + # + # + # Other vendors commonly call this "router ID". + "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are + # sent to the peer. + # + # + # Hold time is three times the interval at which keepalive messages are + # sent, and the hold time is the maximum number of seconds allowed to + # elapse between successive keepalive messages that BGP receives from a + # peer. + # + # + # BGP will use the smaller of either the local hold time value or the + # peer's hold time value as the hold time for the BGP connection between + # the two peers. + # + # + # If set, this value must be between 20 and 60. The default is 20. + }, + "bgpPeers": [ # BGP information that must be configured into the routing stack to + # establish BGP peering. This information must specify the peer ASN and + # either the interface name, IP address, or peer IP address. Please refer toRFC4273. + { + "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement. + "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode, + # which currently supports the following option: + # + # - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This + # excludes any routes learned for subnets that use + # VPC Network Peering. + # + # + # Note that this field can only be populated if advertise_mode is CUSTOM + # and overrides the list defined for the router (in the "bgp" message). + # These groups are advertised in addition to any specified prefixes. + # Leave this field blank to advertise no custom groups. + "A String", + ], + "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode. + # This field can only be populated if advertise_mode is CUSTOM and + # overrides the list defined for the router (in the "bgp" message). + # These IP ranges are advertised in addition to any specified groups. + # Leave this field blank to advertise no custom IP ranges. + { # Description-tagged IP ranges for the router to advertise. + "description": "A String", # User-specified description for the IP range. + "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string. + }, + ], + "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more + # than one matching route of maximum length, the routes with the lowest + # priority value win. + "bfd": { # BFD configuration for the BGP peering. + "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets + # received from the peer router. The actual value is negotiated between + # the two routers and is equal to the greater of this value and the + # transmit interval of the other router. + # + # + # If set, this value must be between 1000 and 30000. + # + # + # The default is 1000. + "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets + # transmitted to the peer router. The actual value is negotiated between + # the two routers and is equal to the greater of this value and the + # corresponding receive interval of the other router. + # + # + # If set, this value must be between 1000 and 30000. + # + # + # The default is 1000. + "multiplier": 42, # The number of consecutive BFD packets that must be missed + # before BFD declares that a peer is unavailable. + # + # + # If set, the value must be a value between 5 and 16. + # + # + # The default is 5. + "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer. + # + # + # If set to ACTIVE, the Cloud Router will initiate the BFD session for + # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + # peer router to initiate the BFD session for this BGP peer. If set to + # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. + }, + "customLearnedIpRanges": [ # A list of user-defined custom learned route IP address ranges for a BGP + # session. + { + "range": "A String", # The custom learned route IP address range. Must be a valid + # CIDR-formatted prefix. If an IP address is provided without a subnet + # mask, it is interpreted as, for IPv4, a `/32` singular IP address + # range, and, for IPv6, `/128`. + }, + ], + "customLearnedRoutePriority": 42, # The user-defined custom learned route priority for a BGP session. This + # value is applied to all custom learned route ranges for the session. + # You can choose a value from `0` to `65335`. If you don't provide a + # value, Google Cloud assigns a priority of `100` to the ranges. + "enable": "A String", # The status of the BGP peer connection. + # + # + # If set to FALSE, any active session with the peer is terminated and + # all associated routing information is removed. If set to TRUE, the + # peer connection can be established with routing information. The default + # is TRUE. + "enableIpv4": True or False, # Enable IPv4 traffic over BGP Peer. It is enabled by default if + # the peerIpAddress is version 4. + "enableIpv6": True or False, # Enable IPv6 traffic over BGP Peer. It is enabled by default if the + # peerIpAddress is version 6. + "exportPolicies": [ # List of export policies applied to this peer, in the order they must be + # evaluated. The name must correspond to an existing policy that has + # ROUTE_POLICY_TYPE_EXPORT type. + "A String", + ], + "importPolicies": [ # List of import policies applied to this peer, in the order they must be + # evaluated. The name must correspond to an existing policy that has + # ROUTE_POLICY_TYPE_IMPORT type. + "A String", + ], + "interfaceName": "A String", # Name of the interface the BGP peer is associated with. + "ipAddress": "A String", # IP address of the interface inside Google Cloud Platform. + "ipv4NexthopAddress": "A String", # IPv4 address of the interface inside Google Cloud Platform. + "ipv6NexthopAddress": "A String", # IPv6 address of the interface inside Google Cloud Platform. + "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this BGP peer. + # + # - MANAGED_BY_USER is the default value and can be managed by you + # or other users + # - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed + # by Cloud Interconnect, specifically by an InterconnectAttachment of type + # PARTNER. Google automatically creates, updates, and deletes this type of + # BGP peer when the PARTNER InterconnectAttachment is created, updated, + # or deleted. + "md5AuthenticationKeyName": "A String", # Present if MD5 authentication is enabled for the peering. Must be the + # name of one of the entries in the Router.md5_authentication_keys. The + # field must comply with RFC1035. + "name": "A String", # Name of this BGP peer. + # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + # characters long and match the regular expression + # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + # lowercase letter, and all following characters must be a dash, lowercase + # letter, or digit, except the last character, which cannot be a dash. + "peerAsn": 42, # Peer BGP Autonomous System Number (ASN). Each BGP interface may use + # a different value. + "peerIpAddress": "A String", # IP address of the BGP interface outside Google Cloud Platform. + "peerIpv4NexthopAddress": "A String", # IPv4 address of the BGP interface outside Google Cloud Platform. + "peerIpv6NexthopAddress": "A String", # IPv6 address of the BGP interface outside Google Cloud Platform. + "routerApplianceInstance": "A String", # URI of the VM instance that is used as third-party router + # appliances such as Next Gen Firewalls, Virtual Routers, or Router + # Appliances. The VM instance must be located in zones contained in the + # same region as this Cloud Router. + # The VM instance is the peer side of the BGP session. + }, + ], + "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 + # text format. + "description": "A String", # An optional description of this resource. Provide this property when you + # create the resource. + "encryptedInterconnectRouter": True or False, # Indicates if a router is dedicated for use with encrypted VLAN + # attachments (interconnectAttachments). + "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is + # defined by the server. + "interfaces": [ # Router interfaces. + # To create a BGP peer that uses a router interface, + # the interface must have one of the following fields specified: + # + # - linkedVpnTunnel + # - linkedInterconnectAttachment + # - subnetwork + # + # + # You can create a router interface without any of these fields specified. + # However, you cannot create a BGP peer that uses that interface. + { + "ipRange": "A String", # IP address and range of the interface. + # + # - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must + # be a CIDR-formatted string, for example, 169.254.0.1/30. + # Note: Do not truncate the IP address, as it represents the IP address of + # the interface. + # - For Internet Protocol version 6 (IPv6), the value + # must be a unique local address (ULA) range from fdff:1::/64 + # with a mask length of 126 or less. This value should be a CIDR-formatted + # string, for example, fdff:1::1/112. Within the router's + # VPC, this IPv6 prefix will be reserved exclusively for this connection + # and cannot be used for any other purpose. + "ipVersion": "A String", # IP version of this interface. + "linkedInterconnectAttachment": "A String", # URI of the linked Interconnect attachment. It must be in the same region + # as the router. Each interface can have one linked resource, which can be + # a VPN tunnel, an Interconnect attachment, or a subnetwork. + "linkedVpnTunnel": "A String", # URI of the linked VPN tunnel, which must be in the same region as the + # router. Each interface can have one linked resource, which can be + # a VPN tunnel, an Interconnect attachment, or a subnetwork. + "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this interface. + # + # - MANAGED_BY_USER is the default value and can be managed directly + # by users. + # - MANAGED_BY_ATTACHMENT is an interface that is configured and + # managed by Cloud Interconnect, specifically, by an InterconnectAttachment + # of type PARTNER. Google automatically creates, updates, and deletes + # this type of interface when the PARTNER InterconnectAttachment is + # created, updated, or deleted. + "name": "A String", # Name of this interface entry. + # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + # characters long and match the regular expression + # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + # lowercase letter, and all following characters must be a dash, lowercase + # letter, or digit, except the last character, which cannot be a dash. + "privateIpAddress": "A String", # The regional private internal IP address that is used to establish + # BGP sessions to a VM instance acting as a third-party + # Router Appliance, such as a Next Gen Firewall, a Virtual Router, or + # an SD-WAN VM. + "redundantInterface": "A String", # Name of the interface that will be redundant with the current interface + # you are creating. The redundantInterface must belong to the same Cloud + # Router as the interface here. To establish the BGP session to a Router + # Appliance VM, you must create two BGP peers. The two BGP peers must be + # attached to two separate interfaces that are redundant with each other. + # The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must + # be 1-63 characters long and match the regular expression + # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + # lowercase letter, and all following characters must be a dash, lowercase + # letter, or digit, except the last character, which cannot be a dash. + "subnetwork": "A String", # The URI of the subnetwork resource that this interface belongs to, which + # must be in the same region as the Cloud Router. + # When you establish a BGP session to a VM instance using this interface, + # the VM instance must belong to the same subnetwork as the subnetwork + # specified here. + }, + ], + "kind": "compute#router", # Output only. [Output Only] Type of resource. Always compute#router for + # routers. + "md5AuthenticationKeys": [ # Keys used for MD5 authentication. + { + "key": "A String", # [Input only] Value of the key. + # + # For patch and update calls, it can be skipped to + # copy the value from the previous configuration. This is allowed if the + # key with the same name existed before the operation. Maximum length is 80 + # characters. Can only contain printable ASCII characters. + "name": "A String", # Name used to identify the key. + # + # Must be unique within a router. Must be referenced by exactly + # one bgpPeer. Must comply withRFC1035. + }, + ], + "name": "A String", # Name of the resource. Provided by the client when the resource is created. + # The name must be 1-63 characters long, and comply withRFC1035. + # Specifically, the name must be 1-63 characters long and match the regular + # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + # character must be a lowercase letter, and all following characters must + # be a dash, lowercase letter, or digit, except the last character, which + # cannot be a dash. + "nats": [ # A list of NAT services created in this router. + { # Represents a Nat resource. It enables the VMs within the specified + # subnetworks to access Internet without external IP addresses. It specifies + # a list of subnetworks (and the ranges within) that want to use NAT. + # Customers can also provide the external IPs that would be used for NAT. GCP + # would auto-allocate ephemeral IPs if no external IPs are provided. + "autoNetworkTier": "A String", # The network tier to use when automatically reserving NAT IP addresses. + # Must be one of: PREMIUM, STANDARD. + # If not specified, then the current + # project-level default tier is used. + "drainNatIps": [ # A list of URLs of the IP resources to be drained. These IPs + # must be valid static external IPs that have been assigned to the NAT. + # These IPs should be used for updating/patching a NAT only. + "A String", + ], + "enableDynamicPortAllocation": True or False, # Enable Dynamic Port Allocation. + # + # + # If not specified, it is disabled by default. + # + # + # If set to true, + # + # - Dynamic Port Allocation will be enabled on this NAT + # config. + # - enableEndpointIndependentMapping cannot be set to true. + # - If minPorts is set, minPortsPerVm must be set to a + # power of two greater than or equal to 32. If minPortsPerVm is not set, a + # minimum of 32 ports will be allocated to a VM from this NAT + # config. + "enableEndpointIndependentMapping": True or False, + "endpointTypes": [ # List of NAT-ted endpoint types supported by the Nat Gateway. If the list + # is empty, then it will be equivalent to include ENDPOINT_TYPE_VM + "A String", + ], + "icmpIdleTimeoutSec": 42, # Timeout (in seconds) for ICMP connections. Defaults to 30s if not set. + "logConfig": { # Configuration of logging on a NAT. # Configure logging on this NAT. + "enable": True or False, # Indicates whether or not to export logs. This is false by default. + "filter": "A String", # Specify the desired filtering of logs on this NAT. If unspecified, + # logs are exported for all connections handled by this NAT. + # This option can take one of the following values: + # + # - ERRORS_ONLY: Export logs only for connection failures. + # - TRANSLATIONS_ONLY: Export logs only for successful + # connections. + # - ALL: Export logs for all connections, successful and + # unsuccessful. + }, + "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when + # Dynamic Port Allocation is enabled. + # + # + # If Dynamic Port Allocation is not enabled, this field has no effect. + # + # + # If Dynamic Port Allocation is enabled, and this field is set, it must be + # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm + # is not set. + # + # + # If Dynamic Port Allocation is enabled and this field is not set, + # a maximum of 65536 ports will be allocated to a VM from this NAT + # config. + "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not + # set, a default number of ports is allocated to a VM. This is rounded + # up to the nearest power of 2. For example, if the value of this field is + # 50, at least 64 ports are allocated to a VM. + "name": "A String", # Unique name of this Nat service. + # The name must be 1-63 characters long and comply withRFC1035. + "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64 + # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is + # selected for the SubnetworkIpRangeToNat64Option above. + { # Specifies a subnetwork to enable NAT64. + "name": "A String", # URL for the subnetwork resource that will use NAT64. + }, + ], + "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following + # values: + # + # - MANUAL_ONLY: Uses only Nat IP addresses provided by + # customers. When there are not enough specified Nat IPs, the Nat service + # fails for new VMs. + # - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + # can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should + # be empty. + "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP + # addresses must be valid static external IP addresses assigned to the + # project. + "A String", + ], + "rules": [ # A list of rules associated with this NAT. + { + "action": { # The action to be enforced for traffic that matches this rule. + "sourceNatActiveIps": [ # A list of URLs of the IP resources used for this NAT rule. These IP + # addresses must be valid static external IP addresses assigned to the + # project. + # This field is used for public NAT. + "A String", + ], + "sourceNatActiveRanges": [ # A list of URLs of the subnetworks used as source ranges for this + # NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. + # This field is used for private NAT. + "A String", + ], + "sourceNatDrainIps": [ # A list of URLs of the IP resources to be drained. These IPs + # must be valid static external IPs that have been assigned to the NAT. + # These IPs should be used for updating/patching a NAT rule only. + # This field is used for public NAT. + "A String", + ], + "sourceNatDrainRanges": [ # A list of URLs of subnetworks representing source ranges to be + # drained. This is only supported on patch/update, and these + # subnetworks must have previously been used as active ranges in this + # NAT Rule. + # This field is used for private NAT. + "A String", + ], + }, + "description": "A String", # An optional description of this rule. + "match": "A String", # CEL expression that specifies the match condition that egress traffic + # from a VM is evaluated against. If it evaluates to true, the + # corresponding `action` is enforced. + # + # The following examples are valid match expressions for public NAT: + # + # `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, + # '2.2.0.0/16')` + # + # `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` + # + # The following example is a valid match expression for private NAT: + # + # `nexthop.hub == + # '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` + "ruleNumber": 42, # An integer uniquely identifying a rule in the list. The rule number + # must be a positive value between 0 and 65000, and + # must be unique among rules within a NAT. + }, + ], + "sourceSubnetworkIpRangesToNat": "A String", # Specify the Nat option, which can take one of the following values: + # + # - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + # Subnetwork are allowed to Nat. + # - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + # in every Subnetwork are allowed to Nat. + # - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat + # (specified in the field subnetwork below) + # + # + # The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. + # Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there + # should not be any other Router.Nat section in any Router for this network + # in this region. + "sourceSubnetworkIpRangesToNat64": "A String", # Specify the Nat option for NAT64, which can take one of the following + # values: + # + # - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + # every Subnetwork are allowed to Nat. + # - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + # (specified in the field nat64_subnetwork below) + # + # + # The default is NAT64_OPTION_UNSPECIFIED. + # Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + # Router.Nat section in this region can also enable NAT64 for any + # Subnetworks in this network. Other Router.Nat sections can still be + # present to enable NAT44 only. + "subnetworks": [ # A list of Subnetwork resources whose traffic should be translated by NAT + # Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the + # SubnetworkIpRangeToNatOption above. + { # Defines the IP ranges that want to use NAT for a subnetwork. + "name": "A String", # URL for the subnetwork resource that will use NAT. + "secondaryIpRangeNames": [ # A list of the secondary ranges of the Subnetwork that are allowed to + # use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" + # is one of the values in source_ip_ranges_to_nat. + "A String", + ], + "sourceIpRangesToNat": [ # Specify the options for NAT ranges in the Subnetwork. All + # options of a single value are valid except + # NAT_IP_RANGE_OPTION_UNSPECIFIED. + # The only valid option with multiple values is: ["PRIMARY_IP_RANGE", + # "LIST_OF_SECONDARY_IP_RANGES"] + # Default: [ALL_IP_RANGES] + "A String", + ], + }, + ], + "tcpEstablishedIdleTimeoutSec": 42, # Timeout (in seconds) for TCP established connections. Defaults to 1200s + # if not set. + "tcpTimeWaitTimeoutSec": 42, # Timeout (in seconds) for TCP connections that are in TIME_WAIT state. + # Defaults to 120s if not set. + "tcpTransitoryIdleTimeoutSec": 42, # Timeout (in seconds) for TCP transitory connections. Defaults to 30s if + # not set. + "type": "A String", # Indicates whether this NAT is used for public or private IP + # translation. If unspecified, it defaults to PUBLIC. + "udpIdleTimeoutSec": 42, # Timeout (in seconds) for UDP connections. Defaults to 30s if not set. + }, + ], + "nccGateway": "A String", # URI of the ncc_gateway to which this router associated. + "network": "A String", # URI of the network to which this router belongs. + "params": { # Additional router parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, + "region": "A String", # [Output Only] URI of the region where the router resides. + # You must specify this field as part of the HTTP request URL. It is + # not settable as a field in the request body. + "selfLink": "A String", # [Output Only] Server-defined URL for the resource. + }, +}
+
+ +
+ testIamPermissions(project, region, resource, body=None, x__xgafv=None) +
Returns permissions that a caller has on the specified resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "permissions": [ # The set of permissions to check for the 'resource'. Permissions with
+      # wildcards (such as '*' or 'storage.*') are not allowed.
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+      # allowed.
+    "A String",
+  ],
+}
+
+ +
+ update(project, region, router, body=None, requestId=None, x__xgafv=None) +
Updates the specified Router resource with the data included in the
+request.  This method conforms toPUT semantics, which requests that the state of the
+target resource be created or replaced with the state defined by the
+representation enclosed in the request message payload.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  router: string, Name of the Router resource to update. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a Cloud Router resource.
+    # 
+    # For more information about Cloud Router, read theCloud
+    # Router overview.
+  "bgp": { # BGP information specific to this router.
+    "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+        # The options are DEFAULT or CUSTOM.
+    "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These groups will be advertised in addition to any specified prefixes.
+        # Leave this field blank to advertise no custom groups.
+      "A String",
+    ],
+    "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+        # This field can only be populated if advertise_mode is CUSTOM and
+        # is advertised to all peers of the router.
+        # These IP ranges will be advertised in addition to any specified groups.
+        # Leave this field blank to advertise no custom IP ranges.
+      { # Description-tagged IP ranges for the router to advertise.
+        "description": "A String", # User-specified description for the IP range.
+        "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
+      },
+    ],
+    "asn": 42, # Local BGP Autonomous System Number (ASN).
+        # Must be anRFC6996 private ASN, either 16-bit or 32-bit. The
+        # value will be fixed for this router resource. All VPN tunnels that link
+        # to this router will have the same local ASN.
+    "identifierRange": "A String", # Explicitly specifies a range of valid BGP Identifiers for this Router. It
+        # is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at
+        # least /30, even if the BGP sessions are over IPv6. It must not overlap
+        # with any IPv4 BGP session ranges.
+        #
+        #
+        # Other vendors commonly call this "router ID".
+    "keepaliveInterval": 42, # The interval in seconds between BGP keepalive messages that are
+        # sent to the peer.
+        #
+        #
+        # Hold time is three times the interval at which keepalive messages are
+        # sent, and the hold time is the maximum number of seconds allowed to
+        # elapse between successive keepalive messages that BGP receives from a
+        # peer.
+        #
+        #
+        # BGP will use the smaller of either the local hold time value or the
+        # peer's hold time value as the hold time for the BGP connection between
+        # the two peers.
+        #
+        #
+        # If set, this value must be between 20 and 60. The default is 20.
+  },
+  "bgpPeers": [ # BGP information that must be configured into the routing stack to
+      # establish BGP peering. This information must specify the peer ASN and
+      # either the interface name, IP address, or peer IP address. Please refer toRFC4273.
+    {
+      "advertiseMode": "A String", # User-specified flag to indicate which mode to use for advertisement.
+      "advertisedGroups": [ # User-specified list of prefix groups to advertise in custom mode,
+          # which currently supports the following option:
+          #
+          #    - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This
+          #    excludes any routes learned for subnets that use
+          #    VPC Network Peering.
+          #
+          #
+          # Note that this field can only be populated if advertise_mode is CUSTOM
+          # and overrides the list defined for the router (in the "bgp" message).
+          # These groups are advertised in addition to any specified prefixes.
+          # Leave this field blank to advertise no custom groups.
+        "A String",
+      ],
+      "advertisedIpRanges": [ # User-specified list of individual IP ranges to advertise in custom mode.
+          # This field can only be populated if advertise_mode is CUSTOM and
+          # overrides the list defined for the router (in the "bgp" message).
+          # These IP ranges are advertised in addition to any specified groups.
+          # Leave this field blank to advertise no custom IP ranges.
+        { # Description-tagged IP ranges for the router to advertise.
+          "description": "A String", # User-specified description for the IP range.
+          "range": "A String", # The IP range to advertise. The value must be a CIDR-formatted string.
+        },
+      ],
+      "advertisedRoutePriority": 42, # The priority of routes advertised to this BGP peer. Where there is more
+          # than one matching route of maximum length, the routes with the lowest
+          # priority value win.
+      "bfd": { # BFD configuration for the BGP peering.
+        "minReceiveInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # received from the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # transmit interval of the other router.
+            #
+            #
+            # If set, this value must be between 1000 and 30000.
+            #
+            #
+            # The default is 1000.
+        "minTransmitInterval": 42, # The minimum interval, in milliseconds, between BFD control packets
+            # transmitted to the peer router. The actual value is negotiated between
+            # the two routers and is equal to the greater of this value and the
+            # corresponding receive interval of the other router.
+            #
+            #
+            # If set, this value must be between 1000 and 30000.
+            #
+            #
+            # The default is 1000.
+        "multiplier": 42, # The number of consecutive BFD packets that must be missed
+            # before BFD declares that a peer is unavailable.
+            #
+            #
+            # If set, the value must be a value between 5 and 16.
+            #
+            #
+            # The default is 5.
+        "sessionInitializationMode": "A String", # The BFD session initialization mode for this BGP peer.
+            #
+            #
+            # If set to ACTIVE, the Cloud Router will initiate the BFD session for
+            # this BGP peer. If set to PASSIVE, the Cloud Router will wait for the
+            # peer router to initiate the BFD session for this BGP peer. If set to
+            # DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
+      },
+      "customLearnedIpRanges": [ # A list of user-defined custom learned route IP address ranges for a BGP
+          # session.
+        {
+          "range": "A String", # The custom learned route IP address range. Must be a valid
+              # CIDR-formatted prefix. If an IP address is provided without a subnet
+              # mask, it is interpreted as, for IPv4, a `/32` singular IP address
+              # range, and, for IPv6, `/128`.
+        },
+      ],
+      "customLearnedRoutePriority": 42, # The user-defined custom learned route priority for a BGP session. This
+          # value is applied to all custom learned route ranges for the session.
+          # You can choose a value from `0` to `65335`. If you don't provide a
+          # value, Google Cloud assigns a priority of `100` to the ranges.
+      "enable": "A String", # The status of the BGP peer connection.
+          #
+          #
+          # If set to FALSE, any active session with the peer is terminated and
+          # all associated routing information is removed. If set to TRUE, the
+          # peer connection can be established with routing information. The default
+          # is TRUE.
+      "enableIpv4": True or False, # Enable IPv4 traffic over BGP Peer. It is enabled by default if
+          # the peerIpAddress is version 4.
+      "enableIpv6": True or False, # Enable IPv6 traffic over BGP Peer. It is enabled by default if the
+          # peerIpAddress is version 6.
+      "exportPolicies": [ # List of export policies applied to this peer, in the order they must be
+          # evaluated. The name must correspond to an existing policy that has
+          # ROUTE_POLICY_TYPE_EXPORT type.
+        "A String",
+      ],
+      "importPolicies": [ # List of import policies applied to this peer, in the order they must be
+          # evaluated. The name must correspond to an existing policy that has
+          # ROUTE_POLICY_TYPE_IMPORT type.
+        "A String",
+      ],
+      "interfaceName": "A String", # Name of the interface the BGP peer is associated with.
+      "ipAddress": "A String", # IP address of the interface inside Google Cloud Platform.
+      "ipv4NexthopAddress": "A String", # IPv4 address of the interface inside Google Cloud Platform.
+      "ipv6NexthopAddress": "A String", # IPv6 address of the interface inside Google Cloud Platform.
+      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this BGP peer.
+          #
+          #    -  MANAGED_BY_USER is the default value and can be managed by you
+          #    or other users
+          #    - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed
+          #    by Cloud Interconnect, specifically by an InterconnectAttachment of type
+          #    PARTNER. Google automatically creates, updates, and deletes this type of
+          #    BGP peer when the PARTNER InterconnectAttachment is created, updated,
+          #    or deleted.
+      "md5AuthenticationKeyName": "A String", # Present if MD5 authentication is enabled for the peering. Must be the
+          # name of one of the entries in the Router.md5_authentication_keys. The
+          # field must comply with RFC1035.
+      "name": "A String", # Name of this BGP peer.
+          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
+          # characters long and match the regular expression
+          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
+          # lowercase letter, and all following characters must be a dash, lowercase
+          # letter, or digit, except the last character, which cannot be a dash.
+      "peerAsn": 42, # Peer BGP Autonomous System Number (ASN). Each BGP interface may use
+          # a different value.
+      "peerIpAddress": "A String", # IP address of the BGP interface outside Google Cloud Platform.
+      "peerIpv4NexthopAddress": "A String", # IPv4 address of the BGP interface outside Google Cloud Platform.
+      "peerIpv6NexthopAddress": "A String", # IPv6 address of the BGP interface outside Google Cloud Platform.
+      "routerApplianceInstance": "A String", # URI of the VM instance that is used as third-party router
+          # appliances such as Next Gen Firewalls, Virtual Routers, or Router
+          # Appliances. The VM instance must be located in zones contained in the
+          # same region as this Cloud Router.
+          # The VM instance is the peer side of the BGP session.
+    },
+  ],
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "encryptedInterconnectRouter": True or False, # Indicates if a router is dedicated for use with encrypted VLAN
+      # attachments (interconnectAttachments).
+  "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "interfaces": [ # Router interfaces.
+      # To create a BGP peer that uses a router interface,
+      # the interface must have one of the following fields specified:
+      # 
+      #    - linkedVpnTunnel
+      #    - linkedInterconnectAttachment
+      #    - subnetwork
+      # 
+      # 
+      # You can create a router interface without any of these fields specified.
+      # However, you cannot create a BGP peer that uses that interface.
+    {
+      "ipRange": "A String", # IP address and range of the interface.
+          #
+          #    - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must
+          #    be a CIDR-formatted string, for example, 169.254.0.1/30.
+          #    Note: Do not truncate the IP address, as it represents the IP address of
+          #    the interface.
+          #    - For Internet Protocol version 6 (IPv6), the value
+          #    must be a unique local address (ULA) range from fdff:1::/64
+          #    with a mask length of 126 or less. This value should be a CIDR-formatted
+          #    string, for example, fdff:1::1/112. Within the router's
+          #    VPC, this IPv6 prefix will be reserved exclusively for this connection
+          #    and cannot be used for any other purpose.
+      "ipVersion": "A String", # IP version of this interface.
+      "linkedInterconnectAttachment": "A String", # URI of the linked Interconnect attachment. It must be in the same region
+          # as the router. Each interface can have one linked resource, which can be
+          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
+      "linkedVpnTunnel": "A String", # URI of the linked VPN tunnel, which must be in the same region as the
+          # router. Each interface can have one linked resource, which can be
+          # a VPN tunnel, an Interconnect attachment, or a subnetwork.
+      "managementType": "A String", # Output only. [Output Only] The resource that configures and manages this interface.
+          #
+          #    - MANAGED_BY_USER is the default value and can be managed directly
+          #    by users.
+          #    - MANAGED_BY_ATTACHMENT is an interface that is configured and
+          #    managed by Cloud Interconnect, specifically, by an InterconnectAttachment
+          #    of type PARTNER. Google automatically creates, updates, and deletes
+          #    this type of interface when the PARTNER InterconnectAttachment is
+          #    created, updated, or deleted.
+      "name": "A String", # Name of this interface entry.
+          # The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63
+          # characters long and match the regular expression
+          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
+          # lowercase letter, and all following characters must be a dash, lowercase
+          # letter, or digit, except the last character, which cannot be a dash.
+      "privateIpAddress": "A String", # The regional private internal IP address that is used to establish
+          # BGP sessions to a VM instance acting as a third-party
+          # Router Appliance, such as a Next Gen Firewall, a Virtual Router, or
+          # an SD-WAN VM.
+      "redundantInterface": "A String", # Name of the interface that will be redundant with the current interface
+          # you are creating. The redundantInterface must belong to the same Cloud
+          # Router as the interface here. To establish the BGP session to a Router
+          # Appliance VM, you must create two BGP peers. The two BGP peers must be
+          # attached to two separate interfaces that are redundant with each other.
+          # The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must
+          # be 1-63 characters long and match the regular expression
+          # `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a
+          # lowercase letter, and all following characters must be a dash, lowercase
+          # letter, or digit, except the last character, which cannot be a dash.
+      "subnetwork": "A String", # The URI of the subnetwork resource that this interface belongs to, which
+          # must be in the same region as the Cloud Router.
+          # When you establish a BGP session to a VM instance using this interface,
+          # the VM instance must belong to the same subnetwork as the subnetwork
+          # specified here.
+    },
+  ],
+  "kind": "compute#router", # Output only. [Output Only] Type of resource. Always compute#router for
+      # routers.
+  "md5AuthenticationKeys": [ # Keys used for MD5 authentication.
+    {
+      "key": "A String", # [Input only] Value of the key.
+          #
+          # For patch and update calls, it can be skipped to
+          # copy the value from the previous configuration. This is allowed if the
+          # key with the same name existed before the operation. Maximum length is 80
+          # characters. Can only contain printable ASCII characters.
+      "name": "A String", # Name used to identify the key.
+          #
+          # Must be unique within a router. Must be referenced by exactly
+          # one bgpPeer. Must comply withRFC1035.
+    },
+  ],
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created.
+      # The name must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the name must be 1-63 characters long and match the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+      # character must be a lowercase letter, and all following characters must
+      # be a dash, lowercase letter, or digit, except the last character, which
+      # cannot be a dash.
+  "nats": [ # A list of NAT services created in this router.
+    { # Represents a Nat resource. It enables the VMs within the specified
+        # subnetworks to access Internet without external IP addresses. It specifies
+        # a list of subnetworks (and the ranges within) that want to use NAT.
+        # Customers can also provide the external IPs that would be used for NAT. GCP
+        # would auto-allocate ephemeral IPs if no external IPs are provided.
+      "autoNetworkTier": "A String", # The network tier to use when automatically reserving NAT IP addresses.
+          # Must be one of: PREMIUM, STANDARD.
+          # If not specified, then the current
+          # project-level default tier is used.
+      "drainNatIps": [ # A list of URLs of the IP resources to be drained. These IPs
+          # must be valid static external IPs that have been assigned to the NAT.
+          # These IPs should be used for updating/patching a NAT only.
+        "A String",
+      ],
+      "enableDynamicPortAllocation": True or False, # Enable Dynamic Port Allocation.
+          #
+          #
+          # If not specified, it is disabled by default.
+          #
+          #
+          # If set to true,
+          #
+          #    - Dynamic Port Allocation will be enabled on this NAT
+          #    config.
+          #    - enableEndpointIndependentMapping cannot be set to true.
+          #    - If minPorts is set, minPortsPerVm must be set to a
+          #    power of two greater than or equal to 32. If minPortsPerVm is not set, a
+          #    minimum of 32 ports will be allocated to a VM from this NAT
+          #    config.
+      "enableEndpointIndependentMapping": True or False,
+      "endpointTypes": [ # List of NAT-ted endpoint types supported by the Nat Gateway. If the list
+          # is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
+        "A String",
+      ],
+      "icmpIdleTimeoutSec": 42, # Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
+      "logConfig": { # Configuration of logging on a NAT. # Configure logging on this NAT.
+        "enable": True or False, # Indicates whether or not to export logs. This is false by default.
+        "filter": "A String", # Specify the desired filtering of logs on this NAT. If unspecified,
+            # logs are exported for all connections handled by this NAT.
+            # This option can take one of the following values:
+            #
+            #    - ERRORS_ONLY: Export logs only for connection failures.
+            #    - TRANSLATIONS_ONLY: Export logs only for successful
+            #    connections.
+            #    - ALL: Export logs for all connections, successful and
+            #    unsuccessful.
+      },
+      "maxPortsPerVm": 42, # Maximum number of ports allocated to a VM from this NAT config when
+          # Dynamic Port Allocation is enabled.
+          #
+          #
+          # If Dynamic Port Allocation is not enabled, this field has no effect.
+          #
+          #
+          # If Dynamic Port Allocation is enabled, and this field is set, it must be
+          # set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm
+          # is not set.
+          #
+          #
+          # If Dynamic Port Allocation is enabled and this field is not set,
+          # a maximum of 65536 ports will be allocated to a VM from this NAT
+          # config.
+      "minPortsPerVm": 42, # Minimum number of ports allocated to a VM from this NAT config. If not
+          # set, a default number of ports is allocated to a VM. This is rounded
+          # up to the nearest power of 2. For example, if the value of this field is
+          # 50, at least 64 ports are allocated to a VM.
+      "name": "A String", # Unique name of this Nat service.
+          # The name must be 1-63 characters long and comply withRFC1035.
+      "nat64Subnetworks": [ # List of Subnetwork resources whose traffic should be translated by NAT64
+          # Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is
+          # selected for the SubnetworkIpRangeToNat64Option above.
+        { # Specifies a subnetwork to enable NAT64.
+          "name": "A String", # URL for the subnetwork resource that will use NAT64.
+        },
+      ],
+      "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following
+          # values:
+          #
+          #    - MANUAL_ONLY: Uses only Nat IP addresses provided by
+          #    customers. When there are not enough specified Nat IPs, the Nat service
+          #    fails for new VMs.
+          #    - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers
+          #    can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should
+          #    be empty.
+      "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP
+          # addresses must be valid static external IP addresses assigned to the
+          # project.
+        "A String",
+      ],
+      "rules": [ # A list of rules associated with this NAT.
+        {
+          "action": { # The action to be enforced for traffic that matches this rule.
+            "sourceNatActiveIps": [ # A list of URLs of the IP resources used for this NAT rule. These IP
+                # addresses must be valid static external IP addresses assigned to the
+                # project.
+                # This field is used for public NAT.
+              "A String",
+            ],
+            "sourceNatActiveRanges": [ # A list of URLs of the subnetworks used as source ranges for this
+                # NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT.
+                # This field is used for private NAT.
+              "A String",
+            ],
+            "sourceNatDrainIps": [ # A list of URLs of the IP resources to be drained. These IPs
+                # must be valid static external IPs that have been assigned to the NAT.
+                # These IPs should be used for updating/patching a NAT rule only.
+                # This field is used for public NAT.
+              "A String",
+            ],
+            "sourceNatDrainRanges": [ # A list of URLs of subnetworks representing source ranges to be
+                # drained. This is only supported on patch/update, and these
+                # subnetworks must have previously been used as active ranges in this
+                # NAT Rule.
+                # This field is used for private NAT.
+              "A String",
+            ],
+          },
+          "description": "A String", # An optional description of this rule.
+          "match": "A String", # CEL expression that specifies the match condition that egress traffic
+              # from a VM is evaluated against. If it evaluates to true, the
+              # corresponding `action` is enforced.
+              #
+              # The following examples are valid match expressions for public NAT:
+              #
+              # `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip,
+              #      '2.2.0.0/16')`
+              #
+              # `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'`
+              #
+              # The following example is a valid match expression for private NAT:
+              #
+              # `nexthop.hub ==
+              # '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`
+          "ruleNumber": 42, # An integer uniquely identifying a rule in the list. The rule number
+              # must be a positive value between 0 and 65000, and
+              # must be unique among rules within a NAT.
+        },
+      ],
+      "sourceSubnetworkIpRangesToNat": "A String", # Specify the Nat option, which can take one of the following values:
+          #
+          #    - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every
+          #    Subnetwork are allowed to Nat.
+          #    - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges
+          #    in every Subnetwork are allowed to Nat.
+          #    - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat
+          #    (specified in the field subnetwork below)
+          #
+          #
+          # The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED.
+          # Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there
+          # should not be any other Router.Nat section in any Router for this network
+          # in this region.
+      "sourceSubnetworkIpRangesToNat64": "A String", # Specify the Nat option for NAT64, which can take one of the following
+          # values:
+          #
+          #    - ALL_IPV6_SUBNETWORKS: All of the IP ranges in
+          #    every Subnetwork are allowed to Nat.
+          #    - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat
+          #    (specified in the field nat64_subnetwork below)
+          #
+          #
+          # The default is NAT64_OPTION_UNSPECIFIED.
+          # Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other
+          # Router.Nat section in this region can also enable NAT64 for any
+          # Subnetworks in this network. Other Router.Nat sections can still be
+          # present to enable NAT44 only.
+      "subnetworks": [ # A list of Subnetwork resources whose traffic should be translated by NAT
+          # Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the
+          # SubnetworkIpRangeToNatOption above.
+        { # Defines the IP ranges that want to use NAT for a subnetwork.
+          "name": "A String", # URL for the subnetwork resource that will use NAT.
+          "secondaryIpRangeNames": [ # A list of the secondary ranges of the Subnetwork that are allowed to
+              # use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES"
+              # is one of the values in source_ip_ranges_to_nat.
+            "A String",
+          ],
+          "sourceIpRangesToNat": [ # Specify the options for NAT ranges in the Subnetwork. All
+              # options of a single value are valid except
+              # NAT_IP_RANGE_OPTION_UNSPECIFIED.
+              # The only valid option with multiple values is: ["PRIMARY_IP_RANGE",
+              # "LIST_OF_SECONDARY_IP_RANGES"]
+              # Default: [ALL_IP_RANGES]
+            "A String",
+          ],
+        },
+      ],
+      "tcpEstablishedIdleTimeoutSec": 42, # Timeout (in seconds) for TCP established connections. Defaults to 1200s
+          # if not set.
+      "tcpTimeWaitTimeoutSec": 42, # Timeout (in seconds) for TCP connections that are in TIME_WAIT state.
+          # Defaults to 120s if not set.
+      "tcpTransitoryIdleTimeoutSec": 42, # Timeout (in seconds) for TCP transitory connections. Defaults to 30s if
+          # not set.
+      "type": "A String", # Indicates whether this NAT is used for public or private IP
+          # translation. If unspecified, it defaults to PUBLIC.
+      "udpIdleTimeoutSec": 42, # Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
+    },
+  ],
+  "nccGateway": "A String", # URI of the ncc_gateway to which this router associated.
+  "network": "A String", # URI of the network to which this router belongs.
+  "params": { # Additional router parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
+      # as part of resource payload.
+    "resourceManagerTags": { # Tag keys/values directly bound to this resource.
+        # The field is allowed for INSERT
+        # only. The keys/values to set on the resource should be specified in
+        # either ID { : } or Namespaced format
+        # { : }.
+        # For example the following are valid inputs:
+        # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"}
+        # * {"123/environment" : "production", "345/abc" : "xyz"}
+        # Note:
+        # * Invalid combinations of ID & namespaced format is not supported. For
+        #   instance: {"123/environment" : "tagValues/444"} is invalid.
+        # * Inconsistent format is not supported. For instance:
+        #   {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid.
+      "a_key": "A String",
+    },
+  },
+  "region": "A String", # [Output Only] URI of the region where the router resides.
+      # You must specify this field as part of the HTTP request URL. It is
+      # not settable as a field in the request body.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource.
+    #
+    # Google Compute Engine has three Operation resources:
+    #
+    # * [Global](/compute/docs/reference/rest/beta/globalOperations)
+    # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
+    # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
+    #
+    # You can use an operation resource to manage asynchronous API requests.
+    # For more information, readHandling
+    # API responses.
+    #
+    # Operations can be global, regional or zonal.
+    #
+    #    - For global operations, use the `globalOperations`
+    #    resource.
+    #    - For regional operations, use the
+    #    `regionOperations` resource.
+    #    - For zonal operations, use
+    #    the `zoneOperations` resource.
+    #
+    #
+    #
+    # For more information, read
+    # Global, Regional, and Zonal Resources.
+    #
+    # Note that completed Operation resources have a limited
+    # retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request.
+      # Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is
+      # set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339
+      # text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation,
+      # this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this
+        # operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error
+            # details. There is a set of defined message types to use for providing
+            # details.The syntax depends on the error code. For example,
+            # QuotaExceededInfo will have details when the error code is
+            # QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details.
+                #
+                # Example of an error when contacting the "pubsub.googleapis.com" API when it
+                # is not enabled:
+                #
+                #     { "reason": "API_DISABLED"
+                #       "domain": "googleapis.com"
+                #       "metadata": {
+                #         "resource": "projects/123",
+                #         "service": "pubsub.googleapis.com"
+                #       }
+                #     }
+                #
+                # This response indicates that the pubsub.googleapis.com API is not enabled.
+                #
+                # Example of an error that is returned when attempting to create a Spanner
+                # instance in a region that is out of stock:
+                #
+                #     { "reason": "STOCKOUT"
+                #       "domain": "spanner.googleapis.com",
+                #       "metadata": {
+                #         "availableRegions": "us-central1,us-east2"
+                #       }
+                #     }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain
+                  # is typically the registered service name of the tool or product that
+                  # generates the error. Example: "pubsub.googleapis.com". If the error is
+                  # generated by some common infrastructure, the error domain must be a
+                  # globally unique value that identifies the infrastructure. For Google API
+                  # infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error.
+                  #
+                  # Keys must match a regular expression of `a-z+` but should
+                  # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
+                  # length. When identifying the current value of an exceeded limit, the units
+                  # should be contained in the key, not the value.  For example, rather than
+                  # `{"instanceLimit": "100/request"}`, should be returned as,
+                  # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of
+                  # instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the
+                  # proximate cause of the error. Error reasons are unique within a particular
+                  # domain of errors. This should be at most 63 characters and match a
+                  # regular expression of `A-Z+[A-Z0-9]`, which represents
+                  # UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action.
+                #
+                # For example, if a quota check failed with an error indicating the calling
+                # project hasn't enabled the accessed service, this can contain a URL pointing
+                # directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user
+                # which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at
+                  # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+                  # Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota
+                  #  type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type
+                  # or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error.
+            # This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error
+      # message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error
+      # status code that was returned. For example, a `404` means the
+      # resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is
+      # defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested.
+      # This value is inRFC3339
+      # text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an
+            # error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information
+            # if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for
+      # Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a
+      # group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`,
+      # `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
+      # There is no requirement that this be linear or support any granularity of
+      # operations. This should not be used to guess when the operation will be
+      # complete. This number should monotonically increase as the operation
+      # progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only
+      # applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
+      # this field will contain information on all underlying zonal actions and
+      # their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
+            # populated.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any
+              # user-facing error message should be localized and sent in the
+              # google.rpc.Status.details field, or localized by the client.
         },
-      ],
-      "natIpAllocateOption": "A String", # Specify the NatIpAllocateOption, which can take one of the following
-          # values:
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following:
+            # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server.
+      # This value is inRFC3339
+      # text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the
+      # following:
+      # `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the
+      # operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation
+      # of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For
+      # operations related to creating a snapshot, this points to the disk
+      # that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example:
+      # `user@example.com` or
+      # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the
+      # operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+          # Engine returns NO_RESULTS_ON_PAGE if there
+          # are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key:
+          # value format. For example:
           #
-          #    - MANUAL_ONLY: Uses only Nat IP addresses provided by
-          #    customers. When there are not enough specified Nat IPs, the Nat service
-          #    fails for new VMs.
-          #    - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers
-          #    can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should
-          #    be empty.
-      "natIps": [ # A list of URLs of the IP resources used for this Nat service. These IP
-          # addresses must be valid static external IP addresses assigned to the
-          # project.
-        "A String",
-      ],
-      "rules": [ # A list of rules associated with this NAT.
+          # "data": [
+          #   {
+          #    "key": "scope",
+          #    "value": "zones/us-east1-d"
+          #   }
         {
-          "action": { # The action to be enforced for traffic that matches this rule.
-            "sourceNatActiveIps": [ # A list of URLs of the IP resources used for this NAT rule. These IP
-                # addresses must be valid static external IP addresses assigned to the
-                # project.
-                # This field is used for public NAT.
-              "A String",
-            ],
-            "sourceNatActiveRanges": [ # A list of URLs of the subnetworks used as source ranges for this
-                # NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT.
-                # This field is used for private NAT.
-              "A String",
-            ],
-            "sourceNatDrainIps": [ # A list of URLs of the IP resources to be drained. These IPs
-                # must be valid static external IPs that have been assigned to the NAT.
-                # These IPs should be used for updating/patching a NAT rule only.
-                # This field is used for public NAT.
-              "A String",
-            ],
-            "sourceNatDrainRanges": [ # A list of URLs of subnetworks representing source ranges to be
-                # drained. This is only supported on patch/update, and these
-                # subnetworks must have previously been used as active ranges in this
-                # NAT Rule.
-                # This field is used for private NAT.
-              "A String",
-            ],
-          },
-          "description": "A String", # An optional description of this rule.
-          "match": "A String", # CEL expression that specifies the match condition that egress traffic
-              # from a VM is evaluated against. If it evaluates to true, the
-              # corresponding `action` is enforced.
-              #
-              # The following examples are valid match expressions for public NAT:
-              #
-              # `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip,
-              #      '2.2.0.0/16')`
-              #
-              # `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'`
-              #
-              # The following example is a valid match expression for private NAT:
-              #
-              # `nexthop.hub ==
-              # '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`
-          "ruleNumber": 42, # An integer uniquely identifying a rule in the list. The rule number
-              # must be a positive value between 0 and 65000, and
-              # must be unique among rules within a NAT.
-        },
-      ],
-      "sourceSubnetworkIpRangesToNat": "A String", # Specify the Nat option, which can take one of the following values:
-          #
-          #    - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every
-          #    Subnetwork are allowed to Nat.
-          #    - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges
-          #    in every Subnetwork are allowed to Nat.
-          #    - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat
-          #    (specified in the field subnetwork below)
-          #
-          #
-          # The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED.
-          # Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there
-          # should not be any other Router.Nat section in any Router for this network
-          # in this region.
-      "sourceSubnetworkIpRangesToNat64": "A String", # Specify the Nat option for NAT64, which can take one of the following
-          # values:
-          #
-          #    - ALL_IPV6_SUBNETWORKS: All of the IP ranges in
-          #    every Subnetwork are allowed to Nat.
-          #    - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat
-          #    (specified in the field nat64_subnetwork below)
-          #
-          #
-          # The default is NAT64_OPTION_UNSPECIFIED.
-          # Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other
-          # Router.Nat section in this region can also enable NAT64 for any
-          # Subnetworks in this network. Other Router.Nat sections can still be
-          # present to enable NAT44 only.
-      "subnetworks": [ # A list of Subnetwork resources whose traffic should be translated by NAT
-          # Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the
-          # SubnetworkIpRangeToNatOption above.
-        { # Defines the IP ranges that want to use NAT for a subnetwork.
-          "name": "A String", # URL for the subnetwork resource that will use NAT.
-          "secondaryIpRangeNames": [ # A list of the secondary ranges of the Subnetwork that are allowed to
-              # use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES"
-              # is one of the values in source_ip_ranges_to_nat.
-            "A String",
-          ],
-          "sourceIpRangesToNat": [ # Specify the options for NAT ranges in the Subnetwork. All
-              # options of a single value are valid except
-              # NAT_IP_RANGE_OPTION_UNSPECIFIED.
-              # The only valid option with multiple values is: ["PRIMARY_IP_RANGE",
-              # "LIST_OF_SECONDARY_IP_RANGES"]
-              # Default: [ALL_IP_RANGES]
-            "A String",
-          ],
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being
+              # returned. For example, for warnings where there are no results in a list
+              # request for a particular zone, this key might be scope and
+              # the key value might be the zone name. Other examples might be a key
+              # indicating a deprecated resource and a suggested replacement, or a
+              # warning about invalid network settings (for example, if an instance
+              # attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
         },
       ],
-      "tcpEstablishedIdleTimeoutSec": 42, # Timeout (in seconds) for TCP established connections. Defaults to 1200s
-          # if not set.
-      "tcpTimeWaitTimeoutSec": 42, # Timeout (in seconds) for TCP connections that are in TIME_WAIT state.
-          # Defaults to 120s if not set.
-      "tcpTransitoryIdleTimeoutSec": 42, # Timeout (in seconds) for TCP transitory connections. Defaults to 30s if
-          # not set.
-      "type": "A String", # Indicates whether this NAT is used for public or private IP
-          # translation. If unspecified, it defaults to PUBLIC.
-      "udpIdleTimeoutSec": 42, # Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
     },
   ],
-  "nccGateway": "A String", # URI of the ncc_gateway to which this router associated.
-  "network": "A String", # URI of the network to which this router belongs.
-  "params": { # Additional router parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
-      # as part of resource payload.
-    "resourceManagerTags": { # Tag keys/values directly bound to this resource.
-        # The field is allowed for INSERT
-        # only. The keys/values to set on the resource should be specified in
-        # either ID { : } or Namespaced format
-        # { : }.
-        # For example the following are valid inputs:
-        # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"}
-        # * {"123/environment" : "production", "345/abc" : "xyz"}
-        # Note:
-        # * Invalid combinations of ID & namespaced format is not supported. For
-        #   instance: {"123/environment" : "tagValues/444"} is invalid.
-        # * Inconsistent format is not supported. For instance:
-        #   {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid.
-      "a_key": "A String",
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only
+      # applicable when performing per-zone operations.
+}
+
+ +
+ updateNamedSet(project, region, router, body=None, requestId=None, x__xgafv=None) +
Updates or creates new Named Set
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  router: string, Name of the Router resource where Named Set is defined. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "description": "A String", # An optional description of named set.
+  "elements": [ # CEL expressions that are comparable to constructs of this set's type
+      # (see Policy Language).
+    { # Represents a textual expression in the Common Expression Language (CEL)
+        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # are documented at https://github.com/google/cel-spec.
+        #
+        # Example (Comparison):
+        #
+        #     title: "Summary size limit"
+        #     description: "Determines if a summary is less than 100 chars"
+        #     expression: "document.summary.size() < 100"
+        #
+        # Example (Equality):
+        #
+        #     title: "Requestor is owner"
+        #     description: "Determines if requestor is the document owner"
+        #     expression: "document.owner == request.auth.claims.email"
+        #
+        # Example (Logic):
+        #
+        #     title: "Public documents"
+        #     description: "Determine whether the document should be publicly visible"
+        #     expression: "document.type != 'private' && document.type != 'internal'"
+        #
+        # Example (Data Manipulation):
+        #
+        #     title: "Notification string"
+        #     description: "Create a notification string with a timestamp."
+        #     expression: "'New message received at ' + string(document.create_time)"
+        #
+        # The exact variables and functions that may be referenced within an expression
+        # are determined by the service that evaluates it. See the service
+        # documentation for additional information.
+      "description": "A String", # Optional. Description of the expression. This is a longer text which
+          # describes the expression, e.g. when hovered over it in a UI.
+      "expression": "A String", # Textual representation of an expression in Common Expression Language
+          # syntax.
+      "location": "A String", # Optional. String indicating the location of the expression for error
+          # reporting, e.g. a file name and a position in the file.
+      "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+          # its purpose. This can be used e.g. in UIs which allow to enter the
+          # expression.
     },
-  },
-  "region": "A String", # [Output Only] URI of the region where the router resides.
-      # You must specify this field as part of the HTTP request URL. It is
-      # not settable as a field in the request body.
-  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  ],
+  "fingerprint": "A String", # A fingerprint for the Named Set being applied to this Router, which is
+      # essentially a hash of the Named Set used for optimistic locking.
+      # The fingerprint is initially generated by Compute Engine and changes
+      # after every request to modify or update the Named Set. You must always
+      # provide an up-to-date fingerprint hash in order to update or change
+      # labels.
+      # 
+      # To see the latest fingerprint, make a getNamedSet() request
+      # to retrieve a Named Set.
+  "name": "A String", # This set's name, which must be a resource ID segment and unique within all
+      # named sets owned by the Router. Name should conform to RFC1035.
+  "type": "A String", # This named set's type
 }
 
   requestId: string, An optional request ID to identify requests. Specify a unique request ID so
diff --git a/docs/dyn/compute_beta.snapshotGroups.html b/docs/dyn/compute_beta.snapshotGroups.html
new file mode 100644
index 00000000000..df5f2353c8c
--- /dev/null
+++ b/docs/dyn/compute_beta.snapshotGroups.html
@@ -0,0 +1,2218 @@
+
+
+
+

Compute Engine API . snapshotGroups

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, snapshotGroup, requestId=None, x__xgafv=None)

+

Deletes the specified SnapshotGroup resource

+

+ get(project, snapshotGroup, x__xgafv=None)

+

returns the specified SnapshotGroup resource.

+

+ getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)

+

Gets the access control policy for a resource. May be empty if no such

+

+ insert(project, body=None, requestId=None, x__xgafv=None)

+

Creates a snapshot group in the specified project using the data included

+

+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

+

retrieves the list of SnapshotGroup resources contained within

+

+ list_next()

+

Retrieves the next page of results.

+

+ setIamPolicy(project, resource, body=None, x__xgafv=None)

+

Sets the access control policy on the specified resource.

+

+ testIamPermissions(project, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ delete(project, snapshotGroup, requestId=None, x__xgafv=None) +
Deletes the specified SnapshotGroup resource
+
+Args:
+  project: string, Project ID for this request. (required)
+  snapshotGroup: string, Name of the SnapshotGroup resource to delete. (required)
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource.
+    #
+    # Google Compute Engine has three Operation resources:
+    #
+    # * [Global](/compute/docs/reference/rest/beta/globalOperations)
+    # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
+    # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
+    #
+    # You can use an operation resource to manage asynchronous API requests.
+    # For more information, readHandling
+    # API responses.
+    #
+    # Operations can be global, regional or zonal.
+    #
+    #    - For global operations, use the `globalOperations`
+    #    resource.
+    #    - For regional operations, use the
+    #    `regionOperations` resource.
+    #    - For zonal operations, use
+    #    the `zoneOperations` resource.
+    #
+    #
+    #
+    # For more information, read
+    # Global, Regional, and Zonal Resources.
+    #
+    # Note that completed Operation resources have a limited
+    # retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request.
+      # Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is
+      # set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339
+      # text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation,
+      # this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this
+        # operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error
+            # details. There is a set of defined message types to use for providing
+            # details.The syntax depends on the error code. For example,
+            # QuotaExceededInfo will have details when the error code is
+            # QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details.
+                #
+                # Example of an error when contacting the "pubsub.googleapis.com" API when it
+                # is not enabled:
+                #
+                #     { "reason": "API_DISABLED"
+                #       "domain": "googleapis.com"
+                #       "metadata": {
+                #         "resource": "projects/123",
+                #         "service": "pubsub.googleapis.com"
+                #       }
+                #     }
+                #
+                # This response indicates that the pubsub.googleapis.com API is not enabled.
+                #
+                # Example of an error that is returned when attempting to create a Spanner
+                # instance in a region that is out of stock:
+                #
+                #     { "reason": "STOCKOUT"
+                #       "domain": "spanner.googleapis.com",
+                #       "metadata": {
+                #         "availableRegions": "us-central1,us-east2"
+                #       }
+                #     }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain
+                  # is typically the registered service name of the tool or product that
+                  # generates the error. Example: "pubsub.googleapis.com". If the error is
+                  # generated by some common infrastructure, the error domain must be a
+                  # globally unique value that identifies the infrastructure. For Google API
+                  # infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error.
+                  #
+                  # Keys must match a regular expression of `a-z+` but should
+                  # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
+                  # length. When identifying the current value of an exceeded limit, the units
+                  # should be contained in the key, not the value.  For example, rather than
+                  # `{"instanceLimit": "100/request"}`, should be returned as,
+                  # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of
+                  # instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the
+                  # proximate cause of the error. Error reasons are unique within a particular
+                  # domain of errors. This should be at most 63 characters and match a
+                  # regular expression of `A-Z+[A-Z0-9]`, which represents
+                  # UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action.
+                #
+                # For example, if a quota check failed with an error indicating the calling
+                # project hasn't enabled the accessed service, this can contain a URL pointing
+                # directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user
+                # which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at
+                  # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+                  # Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota
+                  #  type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type
+                  # or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error.
+            # This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error
+      # message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error
+      # status code that was returned. For example, a `404` means the
+      # resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is
+      # defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested.
+      # This value is inRFC3339
+      # text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an
+            # error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information
+            # if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for
+      # Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a
+      # group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`,
+      # `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
+      # There is no requirement that this be linear or support any granularity of
+      # operations. This should not be used to guess when the operation will be
+      # complete. This number should monotonically increase as the operation
+      # progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only
+      # applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
+      # this field will contain information on all underlying zonal actions and
+      # their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
+            # populated.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any
+              # user-facing error message should be localized and sent in the
+              # google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following:
+            # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server.
+      # This value is inRFC3339
+      # text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the
+      # following:
+      # `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the
+      # operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation
+      # of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For
+      # operations related to creating a snapshot, this points to the disk
+      # that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example:
+      # `user@example.com` or
+      # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the
+      # operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+          # Engine returns NO_RESULTS_ON_PAGE if there
+          # are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key:
+          # value format. For example:
+          #
+          # "data": [
+          #   {
+          #    "key": "scope",
+          #    "value": "zones/us-east1-d"
+          #   }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being
+              # returned. For example, for warnings where there are no results in a list
+              # request for a particular zone, this key might be scope and
+              # the key value might be the zone name. Other examples might be a key
+              # indicating a deprecated resource and a suggested replacement, or a
+              # warning about invalid network settings (for example, if an instance
+              # attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only
+      # applicable when performing per-zone operations.
+}
+
+ +
+ get(project, snapshotGroup, x__xgafv=None) +
returns the specified SnapshotGroup resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  snapshotGroup: string, Name of the SnapshotGroup resource to return. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a SnapshotGroup resource.
+    #
+    # A snapshot group is a set of snapshots that represents a point in time state
+    # of a consistency group.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # Optional. An optional description of this resource. Provide this property when you
+      # create the resource.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#snapshotGroup for SnapshotGroup
+      # resources.
+  "name": "A String", # Identifier. Name of the resource; provided by the client when the resource is created.
+      # The name must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the name must be 1-63 characters long and match the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+      # character must be a lowercase letter, and all following characters must be
+      # a dash, lowercase letter, or digit, except the last character, which cannot
+      # be a dash.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id.
+  "sourceInfo": { # Output only. [Output Only]
+    "consistencyGroup": "A String",
+    "consistencyGroupId": "A String",
+  },
+  "sourceInstantSnapshotGroup": "A String", # Input field for the source instant snapshot group.
+  "sourceInstantSnapshotGroupInfo": { # Output only. [Output Only]
+    "instantSnapshotGroup": "A String",
+    "instantSnapshotGroupId": "A String",
+  },
+  "status": "A String", # Output only. [Output Only]
+}
+
+ +
+ getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None) +
Gets the access control policy for a resource. May be empty if no such
+policy or resource exists.
+
+Args:
+  project: string, Project ID for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # 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/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # 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.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions.
+            # Example:
+            #
+            #     {
+            #       "audit_log_configs": [
+            #         {
+            #           "log_type": "DATA_READ",
+            #           "exempted_members": [
+            #             "user:jose@example.com"
+            #           ]
+            #         },
+            #         {
+            #           "log_type": "DATA_WRITE"
+            #         }
+            #       ]
+            #     }
+            #
+            # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+            # jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
+              # permission.
+              # Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging.
+          # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+          # `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally,
+      # may specify a `condition` that determines how and when the `bindings` are
+      # applied. Each of the `bindings` must contain at least one principal.
+      #
+      # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
+      # of these principals can be Google groups. Each occurrence of a principal
+      # counts towards these limits. For example, if the `bindings` grant 50
+      # different roles to `user:alice@example.com`, and not to any other
+      # principal, then you can add another 1,450 principals to the `bindings` in
+      # the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) # 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).
+          # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+          # are documented at https://github.com/google/cel-spec.
+          #
+          # Example (Comparison):
+          #
+          #     title: "Summary size limit"
+          #     description: "Determines if a summary is less than 100 chars"
+          #     expression: "document.summary.size() < 100"
+          #
+          # Example (Equality):
+          #
+          #     title: "Requestor is owner"
+          #     description: "Determines if requestor is the document owner"
+          #     expression: "document.owner == request.auth.claims.email"
+          #
+          # Example (Logic):
+          #
+          #     title: "Public documents"
+          #     description: "Determine whether the document should be publicly visible"
+          #     expression: "document.type != 'private' && document.type != 'internal'"
+          #
+          # Example (Data Manipulation):
+          #
+          #     title: "Notification string"
+          #     description: "Create a notification string with a timestamp."
+          #     expression: "'New message received at ' + string(document.create_time)"
+          #
+          # The exact variables and functions that may be referenced within an expression
+          # are determined by the service that evaluates it. See the service
+          # documentation for additional information.
+        "description": "A String", # Optional. Description of the expression. This is a longer text which
+            # describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language
+            # syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error
+            # reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+            # its purpose. This can be used e.g. in UIs which allow to enter the
+            # expression.
+      },
+      "members": [ # 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`.
+        "A String",
+      ],
+      "role": "A String", # 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).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+      # prevent simultaneous updates of a policy from overwriting each other.
+      # It is strongly suggested that systems make use of the `etag` in the
+      # read-modify-write cycle to perform policy updates in order to avoid race
+      # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+      # systems are expected to put that etag in the request to `setIamPolicy` to
+      # ensure that their change will be applied to the same version of the policy.
+      #
+      # **Important:** If you use IAM Conditions, you must include the `etag` field
+      # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+      # you to overwrite a version `3` policy with a version `1` policy, and all of
+      # the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy.
+      #
+      # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+      # are rejected.
+      #
+      # Any operation that affects conditional role bindings must specify version
+      # `3`. This requirement applies to the following operations:
+      #
+      # * Getting a policy that includes a conditional role binding
+      # * Adding a conditional role binding to a policy
+      # * Changing a conditional role binding in a policy
+      # * Removing any role binding, with or without a condition, from a policy
+      #   that includes conditions
+      #
+      # **Important:** If you use IAM Conditions, you must include the `etag` field
+      # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+      # you to overwrite a version `3` policy with a version `1` policy, and all of
+      # the conditions in the version `3` policy are lost.
+      #
+      # If a policy does not include any conditions, operations on that policy may
+      # specify any valid version or leave the field unset.
+      #
+      # To learn which resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+ +
+ insert(project, body=None, requestId=None, x__xgafv=None) +
Creates a snapshot group in the specified project using the data included
+in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a SnapshotGroup resource.
+    # 
+    # A snapshot group is a set of snapshots that represents a point in time state
+    # of a consistency group.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # Optional. An optional description of this resource. Provide this property when you
+      # create the resource.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#snapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#snapshotGroup for SnapshotGroup
+      # resources.
+  "name": "A String", # Identifier. Name of the resource; provided by the client when the resource is created.
+      # The name must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the name must be 1-63 characters long and match the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+      # character must be a lowercase letter, and all following characters must be
+      # a dash, lowercase letter, or digit, except the last character, which cannot
+      # be a dash.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id.
+  "sourceInfo": { # Output only. [Output Only]
+    "consistencyGroup": "A String",
+    "consistencyGroupId": "A String",
+  },
+  "sourceInstantSnapshotGroup": "A String", # Input field for the source instant snapshot group.
+  "sourceInstantSnapshotGroupInfo": { # Output only. [Output Only]
+    "instantSnapshotGroup": "A String",
+    "instantSnapshotGroupId": "A String",
+  },
+  "status": "A String", # Output only. [Output Only]
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource.
+    #
+    # Google Compute Engine has three Operation resources:
+    #
+    # * [Global](/compute/docs/reference/rest/beta/globalOperations)
+    # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
+    # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
+    #
+    # You can use an operation resource to manage asynchronous API requests.
+    # For more information, readHandling
+    # API responses.
+    #
+    # Operations can be global, regional or zonal.
+    #
+    #    - For global operations, use the `globalOperations`
+    #    resource.
+    #    - For regional operations, use the
+    #    `regionOperations` resource.
+    #    - For zonal operations, use
+    #    the `zoneOperations` resource.
+    #
+    #
+    #
+    # For more information, read
+    # Global, Regional, and Zonal Resources.
+    #
+    # Note that completed Operation resources have a limited
+    # retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request.
+      # Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is
+      # set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339
+      # text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation,
+      # this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this
+        # operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error
+            # details. There is a set of defined message types to use for providing
+            # details.The syntax depends on the error code. For example,
+            # QuotaExceededInfo will have details when the error code is
+            # QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details.
+                #
+                # Example of an error when contacting the "pubsub.googleapis.com" API when it
+                # is not enabled:
+                #
+                #     { "reason": "API_DISABLED"
+                #       "domain": "googleapis.com"
+                #       "metadata": {
+                #         "resource": "projects/123",
+                #         "service": "pubsub.googleapis.com"
+                #       }
+                #     }
+                #
+                # This response indicates that the pubsub.googleapis.com API is not enabled.
+                #
+                # Example of an error that is returned when attempting to create a Spanner
+                # instance in a region that is out of stock:
+                #
+                #     { "reason": "STOCKOUT"
+                #       "domain": "spanner.googleapis.com",
+                #       "metadata": {
+                #         "availableRegions": "us-central1,us-east2"
+                #       }
+                #     }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain
+                  # is typically the registered service name of the tool or product that
+                  # generates the error. Example: "pubsub.googleapis.com". If the error is
+                  # generated by some common infrastructure, the error domain must be a
+                  # globally unique value that identifies the infrastructure. For Google API
+                  # infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error.
+                  #
+                  # Keys must match a regular expression of `a-z+` but should
+                  # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
+                  # length. When identifying the current value of an exceeded limit, the units
+                  # should be contained in the key, not the value.  For example, rather than
+                  # `{"instanceLimit": "100/request"}`, should be returned as,
+                  # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of
+                  # instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the
+                  # proximate cause of the error. Error reasons are unique within a particular
+                  # domain of errors. This should be at most 63 characters and match a
+                  # regular expression of `A-Z+[A-Z0-9]`, which represents
+                  # UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action.
+                #
+                # For example, if a quota check failed with an error indicating the calling
+                # project hasn't enabled the accessed service, this can contain a URL pointing
+                # directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user
+                # which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at
+                  # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+                  # Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota
+                  #  type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type
+                  # or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error.
+            # This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error
+      # message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error
+      # status code that was returned. For example, a `404` means the
+      # resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is
+      # defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested.
+      # This value is inRFC3339
+      # text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an
+            # error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information
+            # if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for
+      # Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a
+      # group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`,
+      # `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
+      # There is no requirement that this be linear or support any granularity of
+      # operations. This should not be used to guess when the operation will be
+      # complete. This number should monotonically increase as the operation
+      # progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only
+      # applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
+      # this field will contain information on all underlying zonal actions and
+      # their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
+            # populated.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any
+              # user-facing error message should be localized and sent in the
+              # google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following:
+            # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server.
+      # This value is inRFC3339
+      # text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the
+      # following:
+      # `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the
+      # operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation
+      # of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For
+      # operations related to creating a snapshot, this points to the disk
+      # that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example:
+      # `user@example.com` or
+      # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the
+      # operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+          # Engine returns NO_RESULTS_ON_PAGE if there
+          # are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key:
+          # value format. For example:
+          #
+          # "data": [
+          #   {
+          #    "key": "scope",
+          #    "value": "zones/us-east1-d"
+          #   }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being
+              # returned. For example, for warnings where there are no results in a list
+              # request for a particular zone, this key might be scope and
+              # the key value might be the zone name. Other examples might be a key
+              # indicating a deprecated resource and a suggested replacement, or a
+              # warning about invalid network settings (for example, if an instance
+              # attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only
+      # applicable when performing per-zone operations.
+}
+
+ +
+ list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None) +
retrieves the list of SnapshotGroup resources contained within
+the specified project.
+
+Args:
+  project: string, Project ID for this request. (required)
+  filter: string, A filter expression that filters resources listed in the response. Most
+Compute resources support two types of filter expressions:
+expressions that support regular expressions and expressions that follow
+API improvement proposal AIP-160.
+These two types of filter expressions cannot be mixed in one request.
+
+If you want to use AIP-160, your expression must specify the field name, an
+operator, and the value that you want to use for filtering. The value
+must be a string, a number, or a boolean. The operator
+must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
+
+For example, if you are filtering Compute Engine instances, you can
+exclude instances named `example-instance` by specifying
+`name != example-instance`.
+
+The `:*` comparison can be used to test whether a key has been defined.
+For example, to find all objects with `owner` label use:
+```
+labels.owner:*
+```
+
+You can also filter nested fields. For example, you could specify
+`scheduling.automaticRestart = false` to include instances only
+if they are not scheduled for automatic restarts. You can use filtering
+on nested fields to filter based onresource labels.
+
+To filter on multiple expressions, provide each separate expression within
+parentheses. For example:
+```
+(scheduling.automaticRestart = true)
+(cpuPlatform = "Intel Skylake")
+```
+By default, each expression is an `AND` expression. However, you
+can include `AND` and `OR` expressions explicitly.
+For example:
+```
+(cpuPlatform = "Intel Skylake") OR
+(cpuPlatform = "Intel Broadwell") AND
+(scheduling.automaticRestart = true)
+```
+
+If you want to use a regular expression, use the `eq` (equal) or `ne`
+(not equal) operator against a single un-parenthesized expression with or
+without quotes or against multiple parenthesized expressions. Examples:
+
+`fieldname eq unquoted literal`
+`fieldname eq 'single quoted literal'`
+`fieldname eq "double quoted literal"`
+`(fieldname1 eq literal) (fieldname2 ne "literal")`
+
+The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
+The literal value must match the entire field.
+
+For example, to filter for instances that do not end with name "instance",
+you would use `name ne .*instance`.
+
+You cannot combine constraints on multiple fields using regular
+expressions.
+  maxResults: integer, The maximum number of results per page that should be returned.
+If the number of available results is larger than `maxResults`,
+Compute Engine returns a `nextPageToken` that can be used to get
+the next page of results in subsequent list requests. Acceptable values are
+`0` to `500`, inclusive. (Default: `500`)
+  orderBy: string, Sorts list results by a certain order. By default, results
+are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation
+timestamp using `orderBy="creationTimestamp desc"`. This sorts
+results based on the `creationTimestamp` field in
+reverse chronological order (newest result first). Use this to sort
+resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by `name` or
+`creationTimestamp desc` is supported.
+  pageToken: string, Specifies a page token to use. Set `pageToken` to the
+`nextPageToken` returned by a previous list request to get
+the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
+of failure. The default value is false.
+
+For example, when partial success behavior is enabled, aggregatedList for a
+single zone scope either returns all resources in the zone or no resources,
+with an error code.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of SnapshotGroup resources.
+  "etag": "A String",
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of SnapshotGroup resources.
+    { # Represents a SnapshotGroup resource.
+        #
+        # A snapshot group is a set of snapshots that represents a point in time state
+        # of a consistency group.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # Optional. An optional description of this resource. Provide this property when you
+          # create the resource.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#snapshotGroup", # Output only. [Output Only] Type of the resource. Alwayscompute#snapshotGroup for SnapshotGroup
+          # resources.
+      "name": "A String", # Identifier. Name of the resource; provided by the client when the resource is created.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+          # Specifically, the name must be 1-63 characters long and match the regular
+          # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+          # character must be a lowercase letter, and all following characters must be
+          # a dash, lowercase letter, or digit, except the last character, which cannot
+          # be a dash.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id.
+      "sourceInfo": { # Output only. [Output Only]
+        "consistencyGroup": "A String",
+        "consistencyGroupId": "A String",
+      },
+      "sourceInstantSnapshotGroup": "A String", # Input field for the source instant snapshot group.
+      "sourceInstantSnapshotGroupInfo": { # Output only. [Output Only]
+        "instantSnapshotGroup": "A String",
+        "instantSnapshotGroupId": "A String",
+      },
+      "status": "A String", # Output only. [Output Only]
+    },
+  ],
+  "kind": "compute#snapshotGroupsList", # Output only. Type of resource.
+  "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for
+      # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
+      # the query parameter pageToken in the next list request.
+      # Subsequent list requests will have their own nextPageToken to
+      # continue paging through the results.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "unreachables": [ # Output only. [Output Only] Unreachable resources.
+      # end_interface: MixerListResponseWithEtagBuilder
+    "A String",
+  ],
+  "warning": { # [Output Only] Informational warning message.
+    "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+        # Engine returns NO_RESULTS_ON_PAGE if there
+        # are no results in the response.
+    "data": [ # [Output Only] Metadata about this warning in key:
+        # value format. For example:
+        #
+        # "data": [
+        #   {
+        #    "key": "scope",
+        #    "value": "zones/us-east1-d"
+        #   }
+      {
+        "key": "A String", # [Output Only] A key that provides more detail on the warning being
+            # returned. For example, for warnings where there are no results in a list
+            # request for a particular zone, this key might be scope and
+            # the key value might be the zone name. Other examples might be a key
+            # indicating a deprecated resource and a suggested replacement, or a
+            # warning about invalid network settings (for example, if an instance
+            # attempts to perform IP forwarding but is not enabled for IP forwarding).
+        "value": "A String", # [Output Only] A warning data value corresponding to the key.
+      },
+    ],
+    "message": "A String", # [Output Only] A human-readable description of the warning code.
+  },
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ setIamPolicy(project, resource, body=None, x__xgafv=None) +
Sets the access control policy on the specified resource.
+Replaces any existing policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "bindings": [ # Flatten Policy to create a backward compatible wire-format.
+      # Deprecated. Use 'policy' to specify bindings.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) # 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).
+          # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+          # are documented at https://github.com/google/cel-spec.
+          #
+          # Example (Comparison):
+          #
+          #     title: "Summary size limit"
+          #     description: "Determines if a summary is less than 100 chars"
+          #     expression: "document.summary.size() < 100"
+          #
+          # Example (Equality):
+          #
+          #     title: "Requestor is owner"
+          #     description: "Determines if requestor is the document owner"
+          #     expression: "document.owner == request.auth.claims.email"
+          #
+          # Example (Logic):
+          #
+          #     title: "Public documents"
+          #     description: "Determine whether the document should be publicly visible"
+          #     expression: "document.type != 'private' && document.type != 'internal'"
+          #
+          # Example (Data Manipulation):
+          #
+          #     title: "Notification string"
+          #     description: "Create a notification string with a timestamp."
+          #     expression: "'New message received at ' + string(document.create_time)"
+          #
+          # The exact variables and functions that may be referenced within an expression
+          # are determined by the service that evaluates it. See the service
+          # documentation for additional information.
+        "description": "A String", # Optional. Description of the expression. This is a longer text which
+            # describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language
+            # syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error
+            # reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+            # its purpose. This can be used e.g. in UIs which allow to enter the
+            # expression.
+      },
+      "members": [ # 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`.
+        "A String",
+      ],
+      "role": "A String", # 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).
+    },
+  ],
+  "etag": "A String", # Flatten Policy to create a backward compatible wire-format.
+      # Deprecated. Use 'policy' to specify the etag.
+  "policy": { # An Identity and Access Management (IAM) policy, which specifies access # REQUIRED: The complete policy to be applied to the 'resource'. The size of
+      # the policy is limited to a few 10s of KB. An empty policy is in general a
+      # valid policy but certain services (like Projects) might reject them.
+      # 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/).
+    "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+      { # 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.
+        "auditLogConfigs": [ # The configuration for logging of each type of permission.
+          { # Provides the configuration for logging a type of permissions.
+              # Example:
+              #
+              #     {
+              #       "audit_log_configs": [
+              #         {
+              #           "log_type": "DATA_READ",
+              #           "exempted_members": [
+              #             "user:jose@example.com"
+              #           ]
+              #         },
+              #         {
+              #           "log_type": "DATA_WRITE"
+              #         }
+              #       ]
+              #     }
+              #
+              # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+              # jose@example.com from DATA_READ logging.
+            "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
+                # permission.
+                # Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging.
+            # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+            # `allServices` is a special value that covers all services.
+      },
+    ],
+    "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally,
+        # may specify a `condition` that determines how and when the `bindings` are
+        # applied. Each of the `bindings` must contain at least one principal.
+        #
+        # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
+        # of these principals can be Google groups. Each occurrence of a principal
+        # counts towards these limits. For example, if the `bindings` grant 50
+        # different roles to `user:alice@example.com`, and not to any other
+        # principal, then you can add another 1,450 principals to the `bindings` in
+        # the `Policy`.
+      { # Associates `members`, or principals, with a `role`.
+        "condition": { # Represents a textual expression in the Common Expression Language (CEL) # 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).
+            # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+            # are documented at https://github.com/google/cel-spec.
+            #
+            # Example (Comparison):
+            #
+            #     title: "Summary size limit"
+            #     description: "Determines if a summary is less than 100 chars"
+            #     expression: "document.summary.size() < 100"
+            #
+            # Example (Equality):
+            #
+            #     title: "Requestor is owner"
+            #     description: "Determines if requestor is the document owner"
+            #     expression: "document.owner == request.auth.claims.email"
+            #
+            # Example (Logic):
+            #
+            #     title: "Public documents"
+            #     description: "Determine whether the document should be publicly visible"
+            #     expression: "document.type != 'private' && document.type != 'internal'"
+            #
+            # Example (Data Manipulation):
+            #
+            #     title: "Notification string"
+            #     description: "Create a notification string with a timestamp."
+            #     expression: "'New message received at ' + string(document.create_time)"
+            #
+            # The exact variables and functions that may be referenced within an expression
+            # are determined by the service that evaluates it. See the service
+            # documentation for additional information.
+          "description": "A String", # Optional. Description of the expression. This is a longer text which
+              # describes the expression, e.g. when hovered over it in a UI.
+          "expression": "A String", # Textual representation of an expression in Common Expression Language
+              # syntax.
+          "location": "A String", # Optional. String indicating the location of the expression for error
+              # reporting, e.g. a file name and a position in the file.
+          "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+              # its purpose. This can be used e.g. in UIs which allow to enter the
+              # expression.
+        },
+        "members": [ # 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`.
+          "A String",
+        ],
+        "role": "A String", # 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).
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+        # prevent simultaneous updates of a policy from overwriting each other.
+        # It is strongly suggested that systems make use of the `etag` in the
+        # read-modify-write cycle to perform policy updates in order to avoid race
+        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # ensure that their change will be applied to the same version of the policy.
+        #
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # the conditions in the version `3` policy are lost.
+    "version": 42, # Specifies the format of the policy.
+        #
+        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # are rejected.
+        #
+        # Any operation that affects conditional role bindings must specify version
+        # `3`. This requirement applies to the following operations:
+        #
+        # * Getting a policy that includes a conditional role binding
+        # * Adding a conditional role binding to a policy
+        # * Changing a conditional role binding in a policy
+        # * Removing any role binding, with or without a condition, from a policy
+        #   that includes conditions
+        #
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # the conditions in the version `3` policy are lost.
+        #
+        # If a policy does not include any conditions, operations on that policy may
+        # specify any valid version or leave the field unset.
+        #
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # 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/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # 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.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions.
+            # Example:
+            #
+            #     {
+            #       "audit_log_configs": [
+            #         {
+            #           "log_type": "DATA_READ",
+            #           "exempted_members": [
+            #             "user:jose@example.com"
+            #           ]
+            #         },
+            #         {
+            #           "log_type": "DATA_WRITE"
+            #         }
+            #       ]
+            #     }
+            #
+            # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+            # jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
+              # permission.
+              # Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging.
+          # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+          # `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally,
+      # may specify a `condition` that determines how and when the `bindings` are
+      # applied. Each of the `bindings` must contain at least one principal.
+      #
+      # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
+      # of these principals can be Google groups. Each occurrence of a principal
+      # counts towards these limits. For example, if the `bindings` grant 50
+      # different roles to `user:alice@example.com`, and not to any other
+      # principal, then you can add another 1,450 principals to the `bindings` in
+      # the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) # 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).
+          # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+          # are documented at https://github.com/google/cel-spec.
+          #
+          # Example (Comparison):
+          #
+          #     title: "Summary size limit"
+          #     description: "Determines if a summary is less than 100 chars"
+          #     expression: "document.summary.size() < 100"
+          #
+          # Example (Equality):
+          #
+          #     title: "Requestor is owner"
+          #     description: "Determines if requestor is the document owner"
+          #     expression: "document.owner == request.auth.claims.email"
+          #
+          # Example (Logic):
+          #
+          #     title: "Public documents"
+          #     description: "Determine whether the document should be publicly visible"
+          #     expression: "document.type != 'private' && document.type != 'internal'"
+          #
+          # Example (Data Manipulation):
+          #
+          #     title: "Notification string"
+          #     description: "Create a notification string with a timestamp."
+          #     expression: "'New message received at ' + string(document.create_time)"
+          #
+          # The exact variables and functions that may be referenced within an expression
+          # are determined by the service that evaluates it. See the service
+          # documentation for additional information.
+        "description": "A String", # Optional. Description of the expression. This is a longer text which
+            # describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language
+            # syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error
+            # reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing
+            # its purpose. This can be used e.g. in UIs which allow to enter the
+            # expression.
+      },
+      "members": [ # 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`.
+        "A String",
+      ],
+      "role": "A String", # 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).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
+      # prevent simultaneous updates of a policy from overwriting each other.
+      # It is strongly suggested that systems make use of the `etag` in the
+      # read-modify-write cycle to perform policy updates in order to avoid race
+      # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+      # systems are expected to put that etag in the request to `setIamPolicy` to
+      # ensure that their change will be applied to the same version of the policy.
+      #
+      # **Important:** If you use IAM Conditions, you must include the `etag` field
+      # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+      # you to overwrite a version `3` policy with a version `1` policy, and all of
+      # the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy.
+      #
+      # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+      # are rejected.
+      #
+      # Any operation that affects conditional role bindings must specify version
+      # `3`. This requirement applies to the following operations:
+      #
+      # * Getting a policy that includes a conditional role binding
+      # * Adding a conditional role binding to a policy
+      # * Changing a conditional role binding in a policy
+      # * Removing any role binding, with or without a condition, from a policy
+      #   that includes conditions
+      #
+      # **Important:** If you use IAM Conditions, you must include the `etag` field
+      # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+      # you to overwrite a version `3` policy with a version `1` policy, and all of
+      # the conditions in the version `3` policy are lost.
+      #
+      # If a policy does not include any conditions, operations on that policy may
+      # specify any valid version or leave the field unset.
+      #
+      # To learn which resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+ +
+ testIamPermissions(project, resource, body=None, x__xgafv=None) +
Returns permissions that a caller has on the specified resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "permissions": [ # The set of permissions to check for the 'resource'. Permissions with
+      # wildcards (such as '*' or 'storage.*') are not allowed.
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+      # allowed.
+    "A String",
+  ],
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_beta.snapshots.html b/docs/dyn/compute_beta.snapshots.html index 5ba9709cabb..91c28aace49 100644 --- a/docs/dyn/compute_beta.snapshots.html +++ b/docs/dyn/compute_beta.snapshots.html @@ -318,7 +318,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -398,6 +398,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -543,10 +546,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, ], "warning": { # [Output Only] Informational warning which replaces the list of snapshots @@ -1028,7 +1027,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1108,6 +1107,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -1253,10 +1255,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }
@@ -1732,7 +1730,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1812,6 +1810,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -1957,10 +1958,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so @@ -2428,7 +2425,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2508,6 +2505,9 @@

Method Details

# 4648 base64 encoded SHA-256 hash of the customer-supplied # encryption key that protects this resource. }, + "snapshotGroupId": "A String", # Output only. [Output Only] The unique ID of the snapshot group that this snapshot + # belongs to. + "snapshotGroupName": "A String", # Output only. [Output only] The snapshot group that this snapshot belongs to. "snapshotType": "A String", # Indicates the type of the snapshot. "sourceDisk": "A String", # The source disk used to create this snapshot. "sourceDiskEncryptionKey": { # The customer-supplied @@ -2653,10 +2653,6 @@

Method Details

# multi-regional). "A String", ], - "userLicenses": [ # [Output Only] A list of user provided licenses represented by a list of - # URLs to the license resource. - "A String", - ], }, ], "kind": "compute#snapshotList", # Output only. Type of resource. diff --git a/docs/dyn/compute_beta.zoneVmExtensionPolicies.html b/docs/dyn/compute_beta.zoneVmExtensionPolicies.html index a0b1eaa69c6..55742d6f749 100644 --- a/docs/dyn/compute_beta.zoneVmExtensionPolicies.html +++ b/docs/dyn/compute_beta.zoneVmExtensionPolicies.html @@ -402,8 +402,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -449,7 +449,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. @@ -472,8 +472,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -519,7 +519,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. @@ -912,8 +912,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -959,7 +959,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. @@ -1034,8 +1034,8 @@

Method Details

"creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 # text format. "description": "A String", # An optional description of this resource. - "extensionPolicies": { # Required. A map of extension names (e.g., "cloudops") to their corresponding policy - # configurations. + "extensionPolicies": { # Required. A map of extension names (for example, "ops-agent") to their corresponding + # policy configurations. "a_key": { # Configuration for a specific VM extension. "pinnedVersion": "A String", # Optional. The specific version of the extension to install. If not set, the latest # version is used. @@ -1081,7 +1081,7 @@

Method Details

# The policy priority is an integer from 0 to 65535, inclusive. Lower # integers indicate higher priorities. If you do not specify a priority when # creating a rule, it is assigned a priority of 1000. If priorities are - # equal, the policy with the more recent creation timestamp takes precedence. + # equal, the policy with the most recent creation timestamp takes precedence. "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource's resource id. "state": "A String", # Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING. diff --git a/docs/dyn/compute_v1.backendServices.html b/docs/dyn/compute_v1.backendServices.html index 38eeecaf877..d1899e188d7 100644 --- a/docs/dyn/compute_v1.backendServices.html +++ b/docs/dyn/compute_v1.backendServices.html @@ -675,6 +675,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -1483,6 +1487,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -2578,6 +2587,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -3386,6 +3399,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -4273,6 +4291,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -5081,6 +5103,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -5887,6 +5914,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -6695,6 +6726,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -7262,6 +7298,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -8070,6 +8110,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -8580,6 +8625,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -9388,6 +9437,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -11590,6 +11644,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -12398,6 +12456,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is diff --git a/docs/dyn/compute_v1.disks.html b/docs/dyn/compute_v1.disks.html index 61e25313c5c..b39fc5d394c 100644 --- a/docs/dyn/compute_v1.disks.html +++ b/docs/dyn/compute_v1.disks.html @@ -769,7 +769,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1847,7 +1847,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2869,7 +2869,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3760,7 +3760,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4643,7 +4643,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7662,7 +7662,7 @@

Method Details

update(project, zone, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)
Updates the specified disk with the data included in the request.
 The update is performed only on selected fields included as part
-of update-mask. Only the following fields can be modified: user_license.
+of update-mask.
 
 Args:
   project: string, Project ID for this request. (required)
@@ -7892,7 +7892,7 @@ 

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced diff --git a/docs/dyn/compute_v1.externalVpnGateways.html b/docs/dyn/compute_v1.externalVpnGateways.html index c81a372213d..46e2307004f 100644 --- a/docs/dyn/compute_v1.externalVpnGateways.html +++ b/docs/dyn/compute_v1.externalVpnGateways.html @@ -464,6 +464,25 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "redundancyType": "A String", # Indicates the user-supplied redundancy type of this external VPN gateway. "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. }
@@ -543,6 +562,25 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "redundancyType": "A String", # Indicates the user-supplied redundancy type of this external VPN gateway. "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. } @@ -986,6 +1024,25 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "redundancyType": "A String", # Indicates the user-supplied redundancy type of this external VPN gateway. "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. }, diff --git a/docs/dyn/compute_v1.html b/docs/dyn/compute_v1.html index b8b65e607f0..38772138561 100644 --- a/docs/dyn/compute_v1.html +++ b/docs/dyn/compute_v1.html @@ -384,6 +384,11 @@

Instance Methods

Returns the regionDisks Resource.

+

+ regionHealthAggregationPolicies() +

+

Returns the regionHealthAggregationPolicies Resource.

+

regionHealthCheckServices()

diff --git a/docs/dyn/compute_v1.imageFamilyViews.html b/docs/dyn/compute_v1.imageFamilyViews.html index e50fe3ac7f0..497df85fd4b 100644 --- a/docs/dyn/compute_v1.imageFamilyViews.html +++ b/docs/dyn/compute_v1.imageFamilyViews.html @@ -270,7 +270,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced diff --git a/docs/dyn/compute_v1.images.html b/docs/dyn/compute_v1.images.html index 12e45436b86..c9d98606fb0 100644 --- a/docs/dyn/compute_v1.images.html +++ b/docs/dyn/compute_v1.images.html @@ -886,7 +886,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1363,7 +1363,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2200,7 +2200,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3038,7 +3038,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3557,7 +3557,7 @@

Method Details

# be a dash. "params": { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the image. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the image. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced diff --git a/docs/dyn/compute_v1.instanceTemplates.html b/docs/dyn/compute_v1.instanceTemplates.html index 9c449a76f08..16e235a8dcc 100644 --- a/docs/dyn/compute_v1.instanceTemplates.html +++ b/docs/dyn/compute_v1.instanceTemplates.html @@ -489,7 +489,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -979,7 +979,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1807,7 +1807,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2297,7 +2297,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -3128,7 +3128,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3618,7 +3618,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -4441,7 +4441,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4931,7 +4931,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_v1.instances.html b/docs/dyn/compute_v1.instances.html index c667b05749e..3411443d679 100644 --- a/docs/dyn/compute_v1.instances.html +++ b/docs/dyn/compute_v1.instances.html @@ -1678,7 +1678,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2282,7 +2282,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2323,6 +2323,7 @@

Method Details

"enableOsInventoryMetadataValue": True or False, # Effective enable-os-inventory value at Instance level. "enableOsconfigMetadataValue": True or False, # Effective enable-osconfig value at Instance level. "enableOsloginMetadataValue": True or False, # Effective enable-oslogin value at Instance level. + "gceContainerDeclarationMetadataValue": True or False, # Effective gce-container-declaration value at Instance level. "serialPortEnableMetadataValue": True or False, # Effective serial-port-enable value at Instance level. "serialPortLoggingEnableMetadataValue": True or False, # Effective serial-port-logging-enable value at Instance level. "vmDnsSettingMetadataValue": "A String", # Effective VM DNS setting at Instance level. @@ -2860,7 +2861,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3598,7 +3599,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4079,7 +4080,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4569,7 +4570,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -4712,6 +4713,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -4722,6 +4730,16 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. + { + "zone": "A String", # The URL of the zone. + # The zone must exist in the region where the request is called. + # Zones must be represented as valid partial URLs, + # such as zones/us-central1-a. + }, + ], }, "minCount": "A String", # The minimum number of instances to create. If no min_count is # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will @@ -6430,7 +6448,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7034,7 +7052,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -7075,6 +7093,7 @@

Method Details

"enableOsInventoryMetadataValue": True or False, # Effective enable-os-inventory value at Instance level. "enableOsconfigMetadataValue": True or False, # Effective enable-osconfig value at Instance level. "enableOsloginMetadataValue": True or False, # Effective enable-oslogin value at Instance level. + "gceContainerDeclarationMetadataValue": True or False, # Effective gce-container-declaration value at Instance level. "serialPortEnableMetadataValue": True or False, # Effective serial-port-enable value at Instance level. "serialPortLoggingEnableMetadataValue": True or False, # Effective serial-port-logging-enable value at Instance level. "vmDnsSettingMetadataValue": "A String", # Effective VM DNS setting at Instance level. @@ -8635,7 +8654,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9239,7 +9258,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -9280,6 +9299,7 @@

Method Details

"enableOsInventoryMetadataValue": True or False, # Effective enable-os-inventory value at Instance level. "enableOsconfigMetadataValue": True or False, # Effective enable-osconfig value at Instance level. "enableOsloginMetadataValue": True or False, # Effective enable-oslogin value at Instance level. + "gceContainerDeclarationMetadataValue": True or False, # Effective gce-container-declaration value at Instance level. "serialPortEnableMetadataValue": True or False, # Effective serial-port-enable value at Instance level. "serialPortLoggingEnableMetadataValue": True or False, # Effective serial-port-logging-enable value at Instance level. "vmDnsSettingMetadataValue": "A String", # Effective VM DNS setting at Instance level. @@ -10157,7 +10177,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -10761,7 +10781,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -10802,6 +10822,7 @@

Method Details

"enableOsInventoryMetadataValue": True or False, # Effective enable-os-inventory value at Instance level. "enableOsconfigMetadataValue": True or False, # Effective enable-osconfig value at Instance level. "enableOsloginMetadataValue": True or False, # Effective enable-oslogin value at Instance level. + "gceContainerDeclarationMetadataValue": True or False, # Effective gce-container-declaration value at Instance level. "serialPortEnableMetadataValue": True or False, # Effective serial-port-enable value at Instance level. "serialPortLoggingEnableMetadataValue": True or False, # Effective serial-port-logging-enable value at Instance level. "vmDnsSettingMetadataValue": "A String", # Effective VM DNS setting at Instance level. @@ -19278,7 +19299,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -19882,7 +19903,7 @@

Method Details

# to 315,576,000,000 inclusive. Note: these bounds are computed from: # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -19923,6 +19944,7 @@

Method Details

"enableOsInventoryMetadataValue": True or False, # Effective enable-os-inventory value at Instance level. "enableOsconfigMetadataValue": True or False, # Effective enable-osconfig value at Instance level. "enableOsloginMetadataValue": True or False, # Effective enable-oslogin value at Instance level. + "gceContainerDeclarationMetadataValue": True or False, # Effective gce-container-declaration value at Instance level. "serialPortEnableMetadataValue": True or False, # Effective serial-port-enable value at Instance level. "serialPortLoggingEnableMetadataValue": True or False, # Effective serial-port-logging-enable value at Instance level. "vmDnsSettingMetadataValue": "A String", # Effective VM DNS setting at Instance level. diff --git a/docs/dyn/compute_v1.machineImages.html b/docs/dyn/compute_v1.machineImages.html index cc99212da67..badaab8d5ed 100644 --- a/docs/dyn/compute_v1.machineImages.html +++ b/docs/dyn/compute_v1.machineImages.html @@ -654,7 +654,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1144,7 +1144,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -2581,7 +2581,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3071,7 +3071,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -4501,7 +4501,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -4991,7 +4991,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_v1.regionBackendServices.html b/docs/dyn/compute_v1.regionBackendServices.html index 342a107e5a7..fe2ab922763 100644 --- a/docs/dyn/compute_v1.regionBackendServices.html +++ b/docs/dyn/compute_v1.regionBackendServices.html @@ -548,6 +548,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -1356,6 +1360,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -2226,6 +2235,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -3034,6 +3047,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -3841,6 +3859,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -4649,6 +4671,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -5219,6 +5246,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -6027,6 +6058,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -6538,6 +6574,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -7346,6 +7386,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is @@ -9265,6 +9310,10 @@

Method Details

# # For usage guidelines, seeUtilization # balancing mode. + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend. + # the backend. + "resourceUri": "A String", # The URI of the resource or system that manages the backend. + }, "preference": "A String", # This field indicates whether this backend should be fully utilized before # sending traffic to backends with default preference. The possible values # are: @@ -10073,6 +10122,11 @@

Method Details

# connections to all healthy endpoints across all zones. }, }, + "orchestrationInfo": { # A message containing information about the resource or system that manages # Information about the resource or system that manages the backend service. + # the backend service. + "resourceUri": "A String", # The resource URI of the resource or system that manages the backend + # service. + }, "outlierDetection": { # Settings controlling the eviction of unhealthy hosts from the load balancing # Settings controlling the ejection of unhealthy backend endpoints from the # load balancing pool of each individual proxy instance that processes the # traffic for the given backend service. If not set, this feature is diff --git a/docs/dyn/compute_v1.regionCommitments.html b/docs/dyn/compute_v1.regionCommitments.html index 1219ffb214b..ef279c49206 100644 --- a/docs/dyn/compute_v1.regionCommitments.html +++ b/docs/dyn/compute_v1.regionCommitments.html @@ -360,6 +360,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -806,6 +818,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -1162,6 +1186,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -1881,6 +1917,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -2288,6 +2336,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). diff --git a/docs/dyn/compute_v1.regionDisks.html b/docs/dyn/compute_v1.regionDisks.html index d2427fd4dc9..e9d28a7e0f4 100644 --- a/docs/dyn/compute_v1.regionDisks.html +++ b/docs/dyn/compute_v1.regionDisks.html @@ -834,7 +834,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1854,7 +1854,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2742,7 +2742,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3625,7 +3625,7 @@

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -6641,8 +6641,7 @@

Method Details

update(project, region, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)
Update the specified disk with the data included in the request. Update is
-performed only on selected fields included as part of update-mask. Only the
-following fields can be modified: user_license.
+performed only on selected fields included as part of update-mask.
 
 Args:
   project: string, Project ID for this request. (required)
@@ -6872,7 +6871,7 @@ 

Method Details

"options": "A String", # Internal use only. "params": { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced diff --git a/docs/dyn/compute_v1.regionHealthAggregationPolicies.html b/docs/dyn/compute_v1.regionHealthAggregationPolicies.html new file mode 100644 index 00000000000..a9f7d1ac315 --- /dev/null +++ b/docs/dyn/compute_v1.regionHealthAggregationPolicies.html @@ -0,0 +1,1658 @@ + + + +

Compute Engine API . regionHealthAggregationPolicies

+

Instance Methods

+

+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)

+

Retrieves the list of all HealthAggregationPolicy resources,

+

+ aggregatedList_next()

+

Retrieves the next page of results.

+

+ close()

+

Close httplib2 connections.

+

+ delete(project, region, healthAggregationPolicy, requestId=None, x__xgafv=None)

+

Deletes the specified HealthAggregationPolicy in the given region.

+

+ get(project, region, healthAggregationPolicy, x__xgafv=None)

+

Returns the specified HealthAggregationPolicy resource in the given region.

+

+ insert(project, region, body=None, requestId=None, x__xgafv=None)

+

Create a HealthAggregationPolicy in the specified project in the given

+

+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

+

Lists the HealthAggregationPolicies for a project in the given region.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(project, region, healthAggregationPolicy, body=None, requestId=None, x__xgafv=None)

+

Updates the specified regional HealthAggregationPolicy

+

+ testIamPermissions(project, region, resource, body=None, x__xgafv=None)

+

Returns permissions that a caller has on the specified resource.

+

Method Details

+
+ aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None) +
Retrieves the list of all HealthAggregationPolicy resources,
+regional and global, available to the specified project.
+
+To prevent failure, it is recommended that you set the
+`returnPartialSuccess` parameter to `true`.
+
+Args:
+  project: string, Name of the project scoping this request. (required)
+  filter: string, A filter expression that filters resources listed in the response. Most
+Compute resources support two types of filter expressions:
+expressions that support regular expressions and expressions that follow
+API improvement proposal AIP-160.
+These two types of filter expressions cannot be mixed in one request.
+
+If you want to use AIP-160, your expression must specify the field name, an
+operator, and the value that you want to use for filtering. The value
+must be a string, a number, or a boolean. The operator
+must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
+
+For example, if you are filtering Compute Engine instances, you can
+exclude instances named `example-instance` by specifying
+`name != example-instance`.
+
+The `:*` comparison can be used to test whether a key has been defined.
+For example, to find all objects with `owner` label use:
+```
+labels.owner:*
+```
+
+You can also filter nested fields. For example, you could specify
+`scheduling.automaticRestart = false` to include instances only
+if they are not scheduled for automatic restarts. You can use filtering
+on nested fields to filter based onresource labels.
+
+To filter on multiple expressions, provide each separate expression within
+parentheses. For example:
+```
+(scheduling.automaticRestart = true)
+(cpuPlatform = "Intel Skylake")
+```
+By default, each expression is an `AND` expression. However, you
+can include `AND` and `OR` expressions explicitly.
+For example:
+```
+(cpuPlatform = "Intel Skylake") OR
+(cpuPlatform = "Intel Broadwell") AND
+(scheduling.automaticRestart = true)
+```
+
+If you want to use a regular expression, use the `eq` (equal) or `ne`
+(not equal) operator against a single un-parenthesized expression with or
+without quotes or against multiple parenthesized expressions. Examples:
+
+`fieldname eq unquoted literal`
+`fieldname eq 'single quoted literal'`
+`fieldname eq "double quoted literal"`
+`(fieldname1 eq literal) (fieldname2 ne "literal")`
+
+The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
+The literal value must match the entire field.
+
+For example, to filter for instances that do not end with name "instance",
+you would use `name ne .*instance`.
+
+You cannot combine constraints on multiple fields using regular
+expressions.
+  includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
+global) should be included in the response. For new resource types added
+after this field, the flag has no effect as new resource types will always
+include every visible scope for each scope type in response. For resource
+types which predate this field, if this flag is omitted or false, only
+scopes of the scope types where the resource type is expected to be found
+will be included.
+  maxResults: integer, The maximum number of results per page that should be returned.
+If the number of available results is larger than `maxResults`,
+Compute Engine returns a `nextPageToken` that can be used to get
+the next page of results in subsequent list requests. Acceptable values are
+`0` to `500`, inclusive. (Default: `500`)
+  orderBy: string, Sorts list results by a certain order. By default, results
+are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation
+timestamp using `orderBy="creationTimestamp desc"`. This sorts
+results based on the `creationTimestamp` field in
+reverse chronological order (newest result first). Use this to sort
+resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by `name` or
+`creationTimestamp desc` is supported.
+  pageToken: string, Specifies a page token to use. Set `pageToken` to the
+`nextPageToken` returned by a previous list request to get
+the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
+of failure. The default value is false.
+
+For example, when partial success behavior is enabled, aggregatedList for a
+single zone scope either returns all resources in the zone or no resources,
+with an error code.
+  serviceProjectNumber: string, The Shared VPC service project id or service project number for which
+aggregated list request is invoked for subnetworks list-usable api.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Contains a list of HealthAggregationPoliciesScopedList.
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": { # A list of HealthAggregationPoliciesScopedList resources.
+    "a_key": { # Name of the scope containing this set of HealthAggregationPolicies.
+      "healthAggregationPolicies": [ # A list of HealthAggregationPolicys contained in this scope.
+        { # Represents a health aggregation policy.
+            #
+            # A health aggregation policy resource defines a policy to aggregate health.
+            #
+            # For more information, see
+            # Health checks overview.
+          "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+              # text format.
+          "description": "A String", # An optional description of this resource. Provide this property when you
+              # create the resource.
+          "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object.
+              # This field is used in optimistic locking. This field will be ignored when
+              # inserting a HealthAggregationPolicy. An up-to-date fingerprint
+              # must be provided in order to patch the HealthAggregationPolicy; Otherwise,
+              # the request will fail with error 412 conditionNotMet. To see
+              # the latest fingerprint, make a get() request to retrieve the
+              # HealthAggregationPolicy.
+          "healthyPercentThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a
+              # percentage) of healthy endpoints required in order to consider the
+              # aggregated health result HEALTHY. Defaults to 60. Must be in
+              # range [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+              # and will be set to the default if unspecified. Note that both this
+              # threshold and minHealthyThreshold must be satisfied in order
+              # for HEALTHY to be the aggregated result. "Endpoints" refers to network
+              # endpoints within a Network Endpoint Group or instances within an Instance
+              # Group.
+          "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+              # defined by the server.
+          "kind": "compute#healthAggregationPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation
+              # policies.
+          "minHealthyThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of
+              # healthy endpoints required in order to consider the aggregated health
+              # result HEALTHY. Defaults to 1. Must be positive. Not
+              # applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+              # and will be set to the default if unspecified. Note that both this
+              # threshold and healthyPercentThreshold must be satisfied in
+              # order for HEALTHY to be the aggregated result. "Endpoints" refers to
+              # network endpoints within a Network Endpoint Group or instances within an
+              # Instance Group.
+          "name": "A String", # Name of the resource. Provided by the client when the resource is created.
+              # The name must be 1-63 characters long, and comply withRFC1035.
+              # Specifically, the name must be 1-63 characters long and match the regular
+              # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+              # character must be a lowercase letter, and all following characters must
+              # be a dash, lowercase letter, or digit, except the last character, which
+              # cannot be a dash.
+          "policyType": "A String", # Specifies the type of the healthAggregationPolicy. The only allowed value
+              # for global resources is DNS_PUBLIC_IP_POLICY. The only allowed
+              # value for regional resources is BACKEND_SERVICE_POLICY. Must
+              # be specified when the healthAggregationPolicy is created, and cannot be
+              # mutated.
+          "region": "A String", # Output only. [Output Only] URL of the region where the health aggregation policy
+              # resides. This field applies only to the regional resource. You must specify
+              # this field as part of the HTTP request URL. It is not settable as a field
+              # in the request body.
+          "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+          "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL with id for the resource.
+        },
+      ],
+      "warning": { # Informational warning which replaces the list of health aggregation
+          # policies when the list is empty.
+        "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+            # Engine returns NO_RESULTS_ON_PAGE if there
+            # are no results in the response.
+        "data": [ # [Output Only] Metadata about this warning in key:
+            # value format. For example:
+            #
+            # "data": [
+            #   {
+            #    "key": "scope",
+            #    "value": "zones/us-east1-d"
+            #   }
+          {
+            "key": "A String", # [Output Only] A key that provides more detail on the warning being
+                # returned. For example, for warnings where there are no results in a list
+                # request for a particular zone, this key might be scope and
+                # the key value might be the zone name. Other examples might be a key
+                # indicating a deprecated resource and a suggested replacement, or a
+                # warning about invalid network settings (for example, if an instance
+                # attempts to perform IP forwarding but is not enabled for IP forwarding).
+            "value": "A String", # [Output Only] A warning data value corresponding to the key.
+          },
+        ],
+        "message": "A String", # [Output Only] A human-readable description of the warning code.
+      },
+    },
+  },
+  "kind": "compute#healthAggregationPolicyAggregatedList", # Output only. Type of resource.
+  "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for
+      # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
+      # the query parameter pageToken in the next list request.
+      # Subsequent list requests will have their own nextPageToken to
+      # continue paging through the results.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource.
+  "unreachables": [ # Output only. [Output Only] Unreachable resources.
+    "A String",
+  ],
+  "warning": { # [Output Only] Informational warning message.
+    "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+        # Engine returns NO_RESULTS_ON_PAGE if there
+        # are no results in the response.
+    "data": [ # [Output Only] Metadata about this warning in key:
+        # value format. For example:
+        #
+        # "data": [
+        #   {
+        #    "key": "scope",
+        #    "value": "zones/us-east1-d"
+        #   }
+      {
+        "key": "A String", # [Output Only] A key that provides more detail on the warning being
+            # returned. For example, for warnings where there are no results in a list
+            # request for a particular zone, this key might be scope and
+            # the key value might be the zone name. Other examples might be a key
+            # indicating a deprecated resource and a suggested replacement, or a
+            # warning about invalid network settings (for example, if an instance
+            # attempts to perform IP forwarding but is not enabled for IP forwarding).
+        "value": "A String", # [Output Only] A warning data value corresponding to the key.
+      },
+    ],
+    "message": "A String", # [Output Only] A human-readable description of the warning code.
+  },
+}
+
+ +
+ aggregatedList_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ close() +
Close httplib2 connections.
+
+ +
+ delete(project, region, healthAggregationPolicy, requestId=None, x__xgafv=None) +
Deletes the specified HealthAggregationPolicy in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthAggregationPolicy: string, Name of the HealthAggregationPolicy resource to delete. (required)
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource.
+    #
+    # Google Compute Engine has three Operation resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/globalOperations)
+    # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
+    # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
+    #
+    # You can use an operation resource to manage asynchronous API requests.
+    # For more information, readHandling
+    # API responses.
+    #
+    # Operations can be global, regional or zonal.
+    #
+    #    - For global operations, use the `globalOperations`
+    #    resource.
+    #    - For regional operations, use the
+    #    `regionOperations` resource.
+    #    - For zonal operations, use
+    #    the `zoneOperations` resource.
+    #
+    #
+    #
+    # For more information, read
+    # Global, Regional, and Zonal Resources.
+    #
+    # Note that completed Operation resources have a limited
+    # retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request.
+      # Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is
+      # set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339
+      # text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation,
+      # this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this
+        # operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error
+            # details. There is a set of defined message types to use for providing
+            # details.The syntax depends on the error code. For example,
+            # QuotaExceededInfo will have details when the error code is
+            # QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details.
+                #
+                # Example of an error when contacting the "pubsub.googleapis.com" API when it
+                # is not enabled:
+                #
+                #     { "reason": "API_DISABLED"
+                #       "domain": "googleapis.com"
+                #       "metadata": {
+                #         "resource": "projects/123",
+                #         "service": "pubsub.googleapis.com"
+                #       }
+                #     }
+                #
+                # This response indicates that the pubsub.googleapis.com API is not enabled.
+                #
+                # Example of an error that is returned when attempting to create a Spanner
+                # instance in a region that is out of stock:
+                #
+                #     { "reason": "STOCKOUT"
+                #       "domain": "spanner.googleapis.com",
+                #       "metadata": {
+                #         "availableRegions": "us-central1,us-east2"
+                #       }
+                #     }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain
+                  # is typically the registered service name of the tool or product that
+                  # generates the error. Example: "pubsub.googleapis.com". If the error is
+                  # generated by some common infrastructure, the error domain must be a
+                  # globally unique value that identifies the infrastructure. For Google API
+                  # infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error.
+                  #
+                  # Keys must match a regular expression of `a-z+` but should
+                  # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
+                  # length. When identifying the current value of an exceeded limit, the units
+                  # should be contained in the key, not the value.  For example, rather than
+                  # `{"instanceLimit": "100/request"}`, should be returned as,
+                  # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of
+                  # instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the
+                  # proximate cause of the error. Error reasons are unique within a particular
+                  # domain of errors. This should be at most 63 characters and match a
+                  # regular expression of `A-Z+[A-Z0-9]`, which represents
+                  # UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action.
+                #
+                # For example, if a quota check failed with an error indicating the calling
+                # project hasn't enabled the accessed service, this can contain a URL pointing
+                # directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user
+                # which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at
+                  # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+                  # Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota
+                  #  type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type
+                  # or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error.
+            # This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error
+      # message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error
+      # status code that was returned. For example, a `404` means the
+      # resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is
+      # defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested.
+      # This value is inRFC3339
+      # text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an
+            # error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information
+            # if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for
+      # Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a
+      # group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`,
+      # `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
+      # There is no requirement that this be linear or support any granularity of
+      # operations. This should not be used to guess when the operation will be
+      # complete. This number should monotonically increase as the operation
+      # progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only
+      # applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
+      # this field will contain information on all underlying zonal actions and
+      # their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
+            # populated.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any
+              # user-facing error message should be localized and sent in the
+              # google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following:
+            # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server.
+      # This value is inRFC3339
+      # text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the
+      # following:
+      # `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the
+      # operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation
+      # of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For
+      # operations related to creating a snapshot, this points to the disk
+      # that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example:
+      # `user@example.com` or
+      # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the
+      # operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+          # Engine returns NO_RESULTS_ON_PAGE if there
+          # are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key:
+          # value format. For example:
+          #
+          # "data": [
+          #   {
+          #    "key": "scope",
+          #    "value": "zones/us-east1-d"
+          #   }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being
+              # returned. For example, for warnings where there are no results in a list
+              # request for a particular zone, this key might be scope and
+              # the key value might be the zone name. Other examples might be a key
+              # indicating a deprecated resource and a suggested replacement, or a
+              # warning about invalid network settings (for example, if an instance
+              # attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only
+      # applicable when performing per-zone operations.
+}
+
+ +
+ get(project, region, healthAggregationPolicy, x__xgafv=None) +
Returns the specified HealthAggregationPolicy resource in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthAggregationPolicy: string, Name of the HealthAggregationPolicy resource to return. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a health aggregation policy.
+    #
+    # A health aggregation policy resource defines a policy to aggregate health.
+    #
+    # For more information, see
+    # Health checks overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object.
+      # This field is used in optimistic locking. This field will be ignored when
+      # inserting a HealthAggregationPolicy. An up-to-date fingerprint
+      # must be provided in order to patch the HealthAggregationPolicy; Otherwise,
+      # the request will fail with error 412 conditionNotMet. To see
+      # the latest fingerprint, make a get() request to retrieve the
+      # HealthAggregationPolicy.
+  "healthyPercentThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a
+      # percentage) of healthy endpoints required in order to consider the
+      # aggregated health result HEALTHY. Defaults to 60. Must be in
+      # range [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+      # and will be set to the default if unspecified. Note that both this
+      # threshold and minHealthyThreshold must be satisfied in order
+      # for HEALTHY to be the aggregated result. "Endpoints" refers to network
+      # endpoints within a Network Endpoint Group or instances within an Instance
+      # Group.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthAggregationPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation
+      # policies.
+  "minHealthyThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of
+      # healthy endpoints required in order to consider the aggregated health
+      # result HEALTHY. Defaults to 1. Must be positive. Not
+      # applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+      # and will be set to the default if unspecified. Note that both this
+      # threshold and healthyPercentThreshold must be satisfied in
+      # order for HEALTHY to be the aggregated result. "Endpoints" refers to
+      # network endpoints within a Network Endpoint Group or instances within an
+      # Instance Group.
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created.
+      # The name must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the name must be 1-63 characters long and match the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+      # character must be a lowercase letter, and all following characters must
+      # be a dash, lowercase letter, or digit, except the last character, which
+      # cannot be a dash.
+  "policyType": "A String", # Specifies the type of the healthAggregationPolicy. The only allowed value
+      # for global resources is DNS_PUBLIC_IP_POLICY. The only allowed
+      # value for regional resources is BACKEND_SERVICE_POLICY. Must
+      # be specified when the healthAggregationPolicy is created, and cannot be
+      # mutated.
+  "region": "A String", # Output only. [Output Only] URL of the region where the health aggregation policy
+      # resides. This field applies only to the regional resource. You must specify
+      # this field as part of the HTTP request URL. It is not settable as a field
+      # in the request body.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL with id for the resource.
+}
+
+ +
+ insert(project, region, body=None, requestId=None, x__xgafv=None) +
Create a HealthAggregationPolicy in the specified project in the given
+region using the parameters that are included in the request.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a health aggregation policy.
+    # 
+    # A health aggregation policy resource defines a policy to aggregate health.
+    # 
+    # For more information, see
+    # Health checks overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object.
+      # This field is used in optimistic locking. This field will be ignored when
+      # inserting a HealthAggregationPolicy. An up-to-date fingerprint
+      # must be provided in order to patch the HealthAggregationPolicy; Otherwise,
+      # the request will fail with error 412 conditionNotMet. To see
+      # the latest fingerprint, make a get() request to retrieve the
+      # HealthAggregationPolicy.
+  "healthyPercentThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a
+      # percentage) of healthy endpoints required in order to consider the
+      # aggregated health result HEALTHY. Defaults to 60. Must be in
+      # range [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+      # and will be set to the default if unspecified. Note that both this
+      # threshold and minHealthyThreshold must be satisfied in order
+      # for HEALTHY to be the aggregated result. "Endpoints" refers to network
+      # endpoints within a Network Endpoint Group or instances within an Instance
+      # Group.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthAggregationPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation
+      # policies.
+  "minHealthyThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of
+      # healthy endpoints required in order to consider the aggregated health
+      # result HEALTHY. Defaults to 1. Must be positive. Not
+      # applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+      # and will be set to the default if unspecified. Note that both this
+      # threshold and healthyPercentThreshold must be satisfied in
+      # order for HEALTHY to be the aggregated result. "Endpoints" refers to
+      # network endpoints within a Network Endpoint Group or instances within an
+      # Instance Group.
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created.
+      # The name must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the name must be 1-63 characters long and match the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+      # character must be a lowercase letter, and all following characters must
+      # be a dash, lowercase letter, or digit, except the last character, which
+      # cannot be a dash.
+  "policyType": "A String", # Specifies the type of the healthAggregationPolicy. The only allowed value
+      # for global resources is DNS_PUBLIC_IP_POLICY. The only allowed
+      # value for regional resources is BACKEND_SERVICE_POLICY. Must
+      # be specified when the healthAggregationPolicy is created, and cannot be
+      # mutated.
+  "region": "A String", # Output only. [Output Only] URL of the region where the health aggregation policy
+      # resides. This field applies only to the regional resource. You must specify
+      # this field as part of the HTTP request URL. It is not settable as a field
+      # in the request body.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL with id for the resource.
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource.
+    #
+    # Google Compute Engine has three Operation resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/globalOperations)
+    # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
+    # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
+    #
+    # You can use an operation resource to manage asynchronous API requests.
+    # For more information, readHandling
+    # API responses.
+    #
+    # Operations can be global, regional or zonal.
+    #
+    #    - For global operations, use the `globalOperations`
+    #    resource.
+    #    - For regional operations, use the
+    #    `regionOperations` resource.
+    #    - For zonal operations, use
+    #    the `zoneOperations` resource.
+    #
+    #
+    #
+    # For more information, read
+    # Global, Regional, and Zonal Resources.
+    #
+    # Note that completed Operation resources have a limited
+    # retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request.
+      # Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is
+      # set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339
+      # text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation,
+      # this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this
+        # operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error
+            # details. There is a set of defined message types to use for providing
+            # details.The syntax depends on the error code. For example,
+            # QuotaExceededInfo will have details when the error code is
+            # QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details.
+                #
+                # Example of an error when contacting the "pubsub.googleapis.com" API when it
+                # is not enabled:
+                #
+                #     { "reason": "API_DISABLED"
+                #       "domain": "googleapis.com"
+                #       "metadata": {
+                #         "resource": "projects/123",
+                #         "service": "pubsub.googleapis.com"
+                #       }
+                #     }
+                #
+                # This response indicates that the pubsub.googleapis.com API is not enabled.
+                #
+                # Example of an error that is returned when attempting to create a Spanner
+                # instance in a region that is out of stock:
+                #
+                #     { "reason": "STOCKOUT"
+                #       "domain": "spanner.googleapis.com",
+                #       "metadata": {
+                #         "availableRegions": "us-central1,us-east2"
+                #       }
+                #     }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain
+                  # is typically the registered service name of the tool or product that
+                  # generates the error. Example: "pubsub.googleapis.com". If the error is
+                  # generated by some common infrastructure, the error domain must be a
+                  # globally unique value that identifies the infrastructure. For Google API
+                  # infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error.
+                  #
+                  # Keys must match a regular expression of `a-z+` but should
+                  # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
+                  # length. When identifying the current value of an exceeded limit, the units
+                  # should be contained in the key, not the value.  For example, rather than
+                  # `{"instanceLimit": "100/request"}`, should be returned as,
+                  # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of
+                  # instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the
+                  # proximate cause of the error. Error reasons are unique within a particular
+                  # domain of errors. This should be at most 63 characters and match a
+                  # regular expression of `A-Z+[A-Z0-9]`, which represents
+                  # UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action.
+                #
+                # For example, if a quota check failed with an error indicating the calling
+                # project hasn't enabled the accessed service, this can contain a URL pointing
+                # directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user
+                # which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at
+                  # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+                  # Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota
+                  #  type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type
+                  # or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error.
+            # This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error
+      # message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error
+      # status code that was returned. For example, a `404` means the
+      # resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is
+      # defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested.
+      # This value is inRFC3339
+      # text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an
+            # error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information
+            # if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for
+      # Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a
+      # group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`,
+      # `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
+      # There is no requirement that this be linear or support any granularity of
+      # operations. This should not be used to guess when the operation will be
+      # complete. This number should monotonically increase as the operation
+      # progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only
+      # applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
+      # this field will contain information on all underlying zonal actions and
+      # their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
+            # populated.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any
+              # user-facing error message should be localized and sent in the
+              # google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following:
+            # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server.
+      # This value is inRFC3339
+      # text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the
+      # following:
+      # `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the
+      # operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation
+      # of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For
+      # operations related to creating a snapshot, this points to the disk
+      # that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example:
+      # `user@example.com` or
+      # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the
+      # operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+          # Engine returns NO_RESULTS_ON_PAGE if there
+          # are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key:
+          # value format. For example:
+          #
+          # "data": [
+          #   {
+          #    "key": "scope",
+          #    "value": "zones/us-east1-d"
+          #   }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being
+              # returned. For example, for warnings where there are no results in a list
+              # request for a particular zone, this key might be scope and
+              # the key value might be the zone name. Other examples might be a key
+              # indicating a deprecated resource and a suggested replacement, or a
+              # warning about invalid network settings (for example, if an instance
+              # attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only
+      # applicable when performing per-zone operations.
+}
+
+ +
+ list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None) +
Lists the HealthAggregationPolicies for a project in the given region.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  filter: string, A filter expression that filters resources listed in the response. Most
+Compute resources support two types of filter expressions:
+expressions that support regular expressions and expressions that follow
+API improvement proposal AIP-160.
+These two types of filter expressions cannot be mixed in one request.
+
+If you want to use AIP-160, your expression must specify the field name, an
+operator, and the value that you want to use for filtering. The value
+must be a string, a number, or a boolean. The operator
+must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
+
+For example, if you are filtering Compute Engine instances, you can
+exclude instances named `example-instance` by specifying
+`name != example-instance`.
+
+The `:*` comparison can be used to test whether a key has been defined.
+For example, to find all objects with `owner` label use:
+```
+labels.owner:*
+```
+
+You can also filter nested fields. For example, you could specify
+`scheduling.automaticRestart = false` to include instances only
+if they are not scheduled for automatic restarts. You can use filtering
+on nested fields to filter based onresource labels.
+
+To filter on multiple expressions, provide each separate expression within
+parentheses. For example:
+```
+(scheduling.automaticRestart = true)
+(cpuPlatform = "Intel Skylake")
+```
+By default, each expression is an `AND` expression. However, you
+can include `AND` and `OR` expressions explicitly.
+For example:
+```
+(cpuPlatform = "Intel Skylake") OR
+(cpuPlatform = "Intel Broadwell") AND
+(scheduling.automaticRestart = true)
+```
+
+If you want to use a regular expression, use the `eq` (equal) or `ne`
+(not equal) operator against a single un-parenthesized expression with or
+without quotes or against multiple parenthesized expressions. Examples:
+
+`fieldname eq unquoted literal`
+`fieldname eq 'single quoted literal'`
+`fieldname eq "double quoted literal"`
+`(fieldname1 eq literal) (fieldname2 ne "literal")`
+
+The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
+The literal value must match the entire field.
+
+For example, to filter for instances that do not end with name "instance",
+you would use `name ne .*instance`.
+
+You cannot combine constraints on multiple fields using regular
+expressions.
+  maxResults: integer, The maximum number of results per page that should be returned.
+If the number of available results is larger than `maxResults`,
+Compute Engine returns a `nextPageToken` that can be used to get
+the next page of results in subsequent list requests. Acceptable values are
+`0` to `500`, inclusive. (Default: `500`)
+  orderBy: string, Sorts list results by a certain order. By default, results
+are returned in alphanumerical order based on the resource name.
+
+You can also sort results in descending order based on the creation
+timestamp using `orderBy="creationTimestamp desc"`. This sorts
+results based on the `creationTimestamp` field in
+reverse chronological order (newest result first). Use this to sort
+resources like operations so that the newest operation is returned first.
+
+Currently, only sorting by `name` or
+`creationTimestamp desc` is supported.
+  pageToken: string, Specifies a page token to use. Set `pageToken` to the
+`nextPageToken` returned by a previous list request to get
+the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
+of failure. The default value is false.
+
+For example, when partial success behavior is enabled, aggregatedList for a
+single zone scope either returns all resources in the zone or no resources,
+with an error code.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+  "items": [ # A list of HealthAggregationPolicy resources.
+    { # Represents a health aggregation policy.
+        #
+        # A health aggregation policy resource defines a policy to aggregate health.
+        #
+        # For more information, see
+        # Health checks overview.
+      "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+          # text format.
+      "description": "A String", # An optional description of this resource. Provide this property when you
+          # create the resource.
+      "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object.
+          # This field is used in optimistic locking. This field will be ignored when
+          # inserting a HealthAggregationPolicy. An up-to-date fingerprint
+          # must be provided in order to patch the HealthAggregationPolicy; Otherwise,
+          # the request will fail with error 412 conditionNotMet. To see
+          # the latest fingerprint, make a get() request to retrieve the
+          # HealthAggregationPolicy.
+      "healthyPercentThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a
+          # percentage) of healthy endpoints required in order to consider the
+          # aggregated health result HEALTHY. Defaults to 60. Must be in
+          # range [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+          # and will be set to the default if unspecified. Note that both this
+          # threshold and minHealthyThreshold must be satisfied in order
+          # for HEALTHY to be the aggregated result. "Endpoints" refers to network
+          # endpoints within a Network Endpoint Group or instances within an Instance
+          # Group.
+      "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+          # defined by the server.
+      "kind": "compute#healthAggregationPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation
+          # policies.
+      "minHealthyThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of
+          # healthy endpoints required in order to consider the aggregated health
+          # result HEALTHY. Defaults to 1. Must be positive. Not
+          # applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+          # and will be set to the default if unspecified. Note that both this
+          # threshold and healthyPercentThreshold must be satisfied in
+          # order for HEALTHY to be the aggregated result. "Endpoints" refers to
+          # network endpoints within a Network Endpoint Group or instances within an
+          # Instance Group.
+      "name": "A String", # Name of the resource. Provided by the client when the resource is created.
+          # The name must be 1-63 characters long, and comply withRFC1035.
+          # Specifically, the name must be 1-63 characters long and match the regular
+          # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+          # character must be a lowercase letter, and all following characters must
+          # be a dash, lowercase letter, or digit, except the last character, which
+          # cannot be a dash.
+      "policyType": "A String", # Specifies the type of the healthAggregationPolicy. The only allowed value
+          # for global resources is DNS_PUBLIC_IP_POLICY. The only allowed
+          # value for regional resources is BACKEND_SERVICE_POLICY. Must
+          # be specified when the healthAggregationPolicy is created, and cannot be
+          # mutated.
+      "region": "A String", # Output only. [Output Only] URL of the region where the health aggregation policy
+          # resides. This field applies only to the regional resource. You must specify
+          # this field as part of the HTTP request URL. It is not settable as a field
+          # in the request body.
+      "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+      "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL with id for the resource.
+    },
+  ],
+  "kind": "compute#healthAggregationPolicyList", # Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation
+      # policies.
+  "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for
+      # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
+      # the query parameter pageToken in the next list request.
+      # Subsequent list requests will have their own nextPageToken to
+      # continue paging through the results.
+  "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
+  "warning": { # [Output Only] Informational warning message.
+    "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+        # Engine returns NO_RESULTS_ON_PAGE if there
+        # are no results in the response.
+    "data": [ # [Output Only] Metadata about this warning in key:
+        # value format. For example:
+        #
+        # "data": [
+        #   {
+        #    "key": "scope",
+        #    "value": "zones/us-east1-d"
+        #   }
+      {
+        "key": "A String", # [Output Only] A key that provides more detail on the warning being
+            # returned. For example, for warnings where there are no results in a list
+            # request for a particular zone, this key might be scope and
+            # the key value might be the zone name. Other examples might be a key
+            # indicating a deprecated resource and a suggested replacement, or a
+            # warning about invalid network settings (for example, if an instance
+            # attempts to perform IP forwarding but is not enabled for IP forwarding).
+        "value": "A String", # [Output Only] A warning data value corresponding to the key.
+      },
+    ],
+    "message": "A String", # [Output Only] A human-readable description of the warning code.
+  },
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ patch(project, region, healthAggregationPolicy, body=None, requestId=None, x__xgafv=None) +
Updates the specified regional HealthAggregationPolicy
+resource with the data included in the request. This method supportsPATCH
+semantics and uses theJSON merge
+patch format and processing rules.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region scoping this request. (required)
+  healthAggregationPolicy: string, Name of the HealthAggregationPolicy to update. The name
+must be 1-63 characters long, and comply with RFC1035. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a health aggregation policy.
+    # 
+    # A health aggregation policy resource defines a policy to aggregate health.
+    # 
+    # For more information, see
+    # Health checks overview.
+  "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339
+      # text format.
+  "description": "A String", # An optional description of this resource. Provide this property when you
+      # create the resource.
+  "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object.
+      # This field is used in optimistic locking. This field will be ignored when
+      # inserting a HealthAggregationPolicy. An up-to-date fingerprint
+      # must be provided in order to patch the HealthAggregationPolicy; Otherwise,
+      # the request will fail with error 412 conditionNotMet. To see
+      # the latest fingerprint, make a get() request to retrieve the
+      # HealthAggregationPolicy.
+  "healthyPercentThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a
+      # percentage) of healthy endpoints required in order to consider the
+      # aggregated health result HEALTHY. Defaults to 60. Must be in
+      # range [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+      # and will be set to the default if unspecified. Note that both this
+      # threshold and minHealthyThreshold must be satisfied in order
+      # for HEALTHY to be the aggregated result. "Endpoints" refers to network
+      # endpoints within a Network Endpoint Group or instances within an Instance
+      # Group.
+  "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is
+      # defined by the server.
+  "kind": "compute#healthAggregationPolicy", # Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation
+      # policies.
+  "minHealthyThreshold": 42, # Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of
+      # healthy endpoints required in order to consider the aggregated health
+      # result HEALTHY. Defaults to 1. Must be positive. Not
+      # applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,
+      # and will be set to the default if unspecified. Note that both this
+      # threshold and healthyPercentThreshold must be satisfied in
+      # order for HEALTHY to be the aggregated result. "Endpoints" refers to
+      # network endpoints within a Network Endpoint Group or instances within an
+      # Instance Group.
+  "name": "A String", # Name of the resource. Provided by the client when the resource is created.
+      # The name must be 1-63 characters long, and comply withRFC1035.
+      # Specifically, the name must be 1-63 characters long and match the regular
+      # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
+      # character must be a lowercase letter, and all following characters must
+      # be a dash, lowercase letter, or digit, except the last character, which
+      # cannot be a dash.
+  "policyType": "A String", # Specifies the type of the healthAggregationPolicy. The only allowed value
+      # for global resources is DNS_PUBLIC_IP_POLICY. The only allowed
+      # value for regional resources is BACKEND_SERVICE_POLICY. Must
+      # be specified when the healthAggregationPolicy is created, and cannot be
+      # mutated.
+  "region": "A String", # Output only. [Output Only] URL of the region where the health aggregation policy
+      # resides. This field applies only to the regional resource. You must specify
+      # this field as part of the HTTP request URL. It is not settable as a field
+      # in the request body.
+  "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource.
+  "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL with id for the resource.
+}
+
+  requestId: string, An optional request ID to identify requests. Specify a unique request ID so
+that if you must retry your request, the server will know to ignore the
+request if it has already been completed.
+
+For example, consider a situation where you make an initial request and
+the request times out. If you make the request again with the same
+request ID, the server can check if original operation with the same
+request ID was received, and if so, will ignore the second request. This
+prevents clients from accidentally creating duplicate commitments.
+
+The request ID must be
+a valid UUID with the exception that zero UUID is not supported
+(00000000-0000-0000-0000-000000000000).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents an Operation resource.
+    #
+    # Google Compute Engine has three Operation resources:
+    #
+    # * [Global](/compute/docs/reference/rest/v1/globalOperations)
+    # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
+    # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
+    #
+    # You can use an operation resource to manage asynchronous API requests.
+    # For more information, readHandling
+    # API responses.
+    #
+    # Operations can be global, regional or zonal.
+    #
+    #    - For global operations, use the `globalOperations`
+    #    resource.
+    #    - For regional operations, use the
+    #    `regionOperations` resource.
+    #    - For zonal operations, use
+    #    the `zoneOperations` resource.
+    #
+    #
+    #
+    # For more information, read
+    # Global, Regional, and Zonal Resources.
+    #
+    # Note that completed Operation resources have a limited
+    # retention period.
+  "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request.
+      # Not present otherwise.
+  "creationTimestamp": "A String", # [Deprecated] This field is deprecated.
+  "description": "A String", # [Output Only] A textual description of the operation, which is
+      # set when the operation is created.
+  "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339
+      # text format.
+  "error": { # [Output Only] If errors are generated during processing of the operation,
+      # this field will be populated.
+    "errors": [ # [Output Only] The array of errors encountered while processing this
+        # operation.
+      {
+        "code": "A String", # [Output Only] The error type identifier for this error.
+        "errorDetails": [ # [Output Only] An optional list of messages that contain the error
+            # details. There is a set of defined message types to use for providing
+            # details.The syntax depends on the error code. For example,
+            # QuotaExceededInfo will have details when the error code is
+            # QUOTA_EXCEEDED.
+          {
+            "errorInfo": { # Describes the cause of the error with structured details.
+                #
+                # Example of an error when contacting the "pubsub.googleapis.com" API when it
+                # is not enabled:
+                #
+                #     { "reason": "API_DISABLED"
+                #       "domain": "googleapis.com"
+                #       "metadata": {
+                #         "resource": "projects/123",
+                #         "service": "pubsub.googleapis.com"
+                #       }
+                #     }
+                #
+                # This response indicates that the pubsub.googleapis.com API is not enabled.
+                #
+                # Example of an error that is returned when attempting to create a Spanner
+                # instance in a region that is out of stock:
+                #
+                #     { "reason": "STOCKOUT"
+                #       "domain": "spanner.googleapis.com",
+                #       "metadata": {
+                #         "availableRegions": "us-central1,us-east2"
+                #       }
+                #     }
+              "domain": "A String", # The logical grouping to which the "reason" belongs. The error domain
+                  # is typically the registered service name of the tool or product that
+                  # generates the error. Example: "pubsub.googleapis.com". If the error is
+                  # generated by some common infrastructure, the error domain must be a
+                  # globally unique value that identifies the infrastructure. For Google API
+                  # infrastructure, the error domain is "googleapis.com".
+              "metadatas": { # Additional structured details about this error.
+                  #
+                  # Keys must match a regular expression of `a-z+` but should
+                  # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
+                  # length. When identifying the current value of an exceeded limit, the units
+                  # should be contained in the key, not the value.  For example, rather than
+                  # `{"instanceLimit": "100/request"}`, should be returned as,
+                  # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of
+                  # instances that can be created in a single (batch) request.
+                "a_key": "A String",
+              },
+              "reason": "A String", # The reason of the error. This is a constant value that identifies the
+                  # proximate cause of the error. Error reasons are unique within a particular
+                  # domain of errors. This should be at most 63 characters and match a
+                  # regular expression of `A-Z+[A-Z0-9]`, which represents
+                  # UPPER_SNAKE_CASE.
+            },
+            "help": { # Provides links to documentation or for performing an out of band action.
+                #
+                # For example, if a quota check failed with an error indicating the calling
+                # project hasn't enabled the accessed service, this can contain a URL pointing
+                # directly to the right place in the developer console to flip the bit.
+              "links": [ # URL(s) pointing to additional information on handling the current error.
+                { # Describes a URL link.
+                  "description": "A String", # Describes what the link offers.
+                  "url": "A String", # The URL of the link.
+                },
+              ],
+            },
+            "localizedMessage": { # Provides a localized error message that is safe to return to the user
+                # which can be attached to an RPC error.
+              "locale": "A String", # The locale used following the specification defined at
+                  # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+                  # Examples are: "en-US", "fr-CH", "es-MX"
+              "message": "A String", # The localized error message in the above locale.
+            },
+            "quotaInfo": { # Additional details for quota exceeded error for resource quota.
+              "dimensions": { # The map holding related quota dimensions.
+                "a_key": "A String",
+              },
+              "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota
+                  #  type or metric.
+              "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type
+                  # or metric.
+              "limitName": "A String", # The name of the quota limit.
+              "metricName": "A String", # The Compute Engine quota metric name.
+              "rolloutStatus": "A String", # Rollout status of the future quota limit.
+            },
+          },
+        ],
+        "location": "A String", # [Output Only] Indicates the field in the request that caused the error.
+            # This property is optional.
+        "message": "A String", # [Output Only] An optional, human-readable error message.
+      },
+    ],
+  },
+  "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error
+      # message that was returned, such as `NOT FOUND`.
+  "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error
+      # status code that was returned. For example, a `404` means the
+      # resource was not found.
+  "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is
+      # defined by the server.
+  "insertTime": "A String", # [Output Only] The time that this operation was requested.
+      # This value is inRFC3339
+      # text format.
+  "instancesBulkInsertOperationMetadata": {
+    "perLocationStatus": { # Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far.
+        "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback.
+        "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an
+            # error.
+        "status": "A String", # [Output Only] Creation status of BulkInsert operation - information
+            # if the flow is rolling forward or rolling back.
+        "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created.
+      },
+    },
+  },
+  "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for
+      # Operation resources.
+  "name": "A String", # [Output Only] Name of the operation.
+  "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a
+      # group of operations results from a `bulkInsert` API request.
+  "operationType": "A String", # [Output Only] The type of operation, such as `insert`,
+      # `update`, or `delete`, and so on.
+  "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
+      # There is no requirement that this be linear or support any granularity of
+      # operations. This should not be used to guess when the operation will be
+      # complete. This number should monotonically increase as the operation
+      # progresses.
+  "region": "A String", # [Output Only] The URL of the region where the operation resides. Only
+      # applicable when performing regional operations.
+  "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
+      # this field will contain information on all underlying zonal actions and
+      # their state.
+    "clientOperationId": "A String", # [Output Only] The client operation id.
+    "perLocationOperations": { # [Output Only] Status information per location (location name is key).
+        # Example key: zones/us-central1-a
+      "a_key": {
+        "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
+            # populated.
+            # different programming environments, including REST APIs and RPC APIs. It is
+            # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+            # three pieces of data: error code, error message, and error details.
+            #
+            # You can find out more about this error model and how to work with it in the
+            # [API Design Guide](https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details.  There is a common set of
+              # message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any
+              # user-facing error message should be localized and sent in the
+              # google.rpc.Status.details field, or localized by the client.
+        },
+        "state": "A String", # [Output Only] Status of the action, which can be one of the following:
+            # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
+      },
+    },
+  },
+  "startTime": "A String", # [Output Only] The time that this operation was started by the server.
+      # This value is inRFC3339
+      # text format.
+  "status": "A String", # [Output Only] The status of the operation, which can be one of the
+      # following:
+      # `PENDING`, `RUNNING`, or `DONE`.
+  "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the
+      # operation.
+  "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation
+      # of the target resource.
+  "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For
+      # operations related to creating a snapshot, this points to the disk
+      # that the snapshot was created from.
+  "user": "A String", # [Output Only] User who requested the operation, for example:
+      # `user@example.com` or
+      # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
+  "warnings": [ # [Output Only] If warning messages are generated during processing of the
+      # operation, this field will be populated.
+    {
+      "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute
+          # Engine returns NO_RESULTS_ON_PAGE if there
+          # are no results in the response.
+      "data": [ # [Output Only] Metadata about this warning in key:
+          # value format. For example:
+          #
+          # "data": [
+          #   {
+          #    "key": "scope",
+          #    "value": "zones/us-east1-d"
+          #   }
+        {
+          "key": "A String", # [Output Only] A key that provides more detail on the warning being
+              # returned. For example, for warnings where there are no results in a list
+              # request for a particular zone, this key might be scope and
+              # the key value might be the zone name. Other examples might be a key
+              # indicating a deprecated resource and a suggested replacement, or a
+              # warning about invalid network settings (for example, if an instance
+              # attempts to perform IP forwarding but is not enabled for IP forwarding).
+          "value": "A String", # [Output Only] A warning data value corresponding to the key.
+        },
+      ],
+      "message": "A String", # [Output Only] A human-readable description of the warning code.
+    },
+  ],
+  "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only
+      # applicable when performing per-zone operations.
+}
+
+ +
+ testIamPermissions(project, region, resource, body=None, x__xgafv=None) +
Returns permissions that a caller has on the specified resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "permissions": [ # The set of permissions to check for the 'resource'. Permissions with
+      # wildcards (such as '*' or 'storage.*') are not allowed.
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
+      # allowed.
+    "A String",
+  ],
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/compute_v1.regionInstanceTemplates.html b/docs/dyn/compute_v1.regionInstanceTemplates.html index 13154466e7e..bf988ed4290 100644 --- a/docs/dyn/compute_v1.regionInstanceTemplates.html +++ b/docs/dyn/compute_v1.regionInstanceTemplates.html @@ -661,7 +661,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1151,7 +1151,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1612,7 +1612,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -2102,7 +2102,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -2926,7 +2926,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -3416,7 +3416,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & diff --git a/docs/dyn/compute_v1.regionInstances.html b/docs/dyn/compute_v1.regionInstances.html index f117f8674ac..2e56a65519b 100644 --- a/docs/dyn/compute_v1.regionInstances.html +++ b/docs/dyn/compute_v1.regionInstances.html @@ -309,7 +309,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -790,7 +790,7 @@

Method Details

# as the instance zone. "A String", ], - "resourceManagerTags": { # Resource manager tags to be bound to the disk. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the disk. Tag keys and values # have the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1280,7 +1280,7 @@

Method Details

"A String", ], }, - "resourceManagerTags": { # Resource manager tags to be bound to the instance. Tag keys and values + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the instance. Tag keys and values # have the same definition as resource # manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and # values are in the format `tagValues/456`. The field is ignored (both PUT & @@ -1423,6 +1423,13 @@

Method Details

"locations": { # Location configurations mapped by location name. # Currently only zone names are supported and must be represented as valid # internal URLs, such as zones/us-central1-a. + # The bulkInsert operation doesn't create instances in an AI zone, even if + # an AI zone is available in the specified region. For example, if you set a + # DENY preference for us-central1-a, Compute Engine will consider + # us-central1-b and us-central1-c for instance creation, but not + # us-central1-ai1a. Also, you can't use the locations[] configuration to + # allow instance creation in an AI zone. To include an AI zone in bulkInsert + # operations, use the locationPolicy.zones[] field. "a_key": { "constraints": { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution # in this zone. @@ -1433,6 +1440,16 @@

Method Details

}, }, "targetShape": "A String", # Strategy for distributing VMs across zones in a region. + "zones": [ # The bulkInsert operation applies any preferences set in the locations + # field to the specific zones listed in the zones field if the same zones + # are specified in both fields. + { + "zone": "A String", # The URL of the zone. + # The zone must exist in the region where the request is called. + # Zones must be represented as valid partial URLs, + # such as zones/us-central1-a. + }, + ], }, "minCount": "A String", # The minimum number of instances to create. If no min_count is # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will diff --git a/docs/dyn/compute_v1.reservations.html b/docs/dyn/compute_v1.reservations.html index b374a41550b..7ac235a2dd1 100644 --- a/docs/dyn/compute_v1.reservations.html +++ b/docs/dyn/compute_v1.reservations.html @@ -307,6 +307,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -903,6 +915,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -1498,6 +1522,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -2088,6 +2124,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). @@ -3852,6 +3900,18 @@

Method Details

# character must be a lowercase letter, and all following characters must be # a dash, lowercase letter, or digit, except the last character, which cannot # be a dash. + "params": { # Additional reservation params. # Input only. Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the reservation. Tag keys and + # values have the same definition as resource + # manager tags. Keys and values can be either in numeric format, + # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + # `{tag_value_short_name}`. The field is ignored (both PUT & + # PATCH) when empty. + "a_key": "A String", + }, + }, "protectionTier": "A String", # Protection tier for the workload which specifies the workload expectations # in the event of infrastructure failures at data center (e.g. power # and/or cooling failures). diff --git a/docs/dyn/compute_v1.snapshots.html b/docs/dyn/compute_v1.snapshots.html index 567d8ca2d6d..b7d049228cf 100644 --- a/docs/dyn/compute_v1.snapshots.html +++ b/docs/dyn/compute_v1.snapshots.html @@ -503,7 +503,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1201,7 +1201,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -1891,7 +1891,7 @@

Method Details

# be a dash. "params": { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted # as part of resource payload. - "resourceManagerTags": { # Resource manager tags to be bound to the snapshot. Tag keys and values have + "resourceManagerTags": { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have # the same definition as resource # manager tags. Keys and values can be either in numeric format, # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced diff --git a/docs/dyn/compute_v1.targetVpnGateways.html b/docs/dyn/compute_v1.targetVpnGateways.html index bc78bc01542..0f663646179 100644 --- a/docs/dyn/compute_v1.targetVpnGateways.html +++ b/docs/dyn/compute_v1.targetVpnGateways.html @@ -255,6 +255,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. # You must specify this field as part of the HTTP request URL. It is # not settable as a field in the request body. @@ -689,6 +708,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. # You must specify this field as part of the HTTP request URL. It is # not settable as a field in the request body. @@ -753,6 +791,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. # You must specify this field as part of the HTTP request URL. It is # not settable as a field in the request body. @@ -1180,6 +1237,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # [Output Only] URL of the region where the target VPN gateway resides. # You must specify this field as part of the HTTP request URL. It is # not settable as a field in the request body. diff --git a/docs/dyn/compute_v1.vpnGateways.html b/docs/dyn/compute_v1.vpnGateways.html index c4fe05087e0..0f102033704 100644 --- a/docs/dyn/compute_v1.vpnGateways.html +++ b/docs/dyn/compute_v1.vpnGateways.html @@ -261,6 +261,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # Output only. [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are @@ -715,6 +734,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # Output only. [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are @@ -849,6 +887,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # Output only. [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are @@ -1295,6 +1352,25 @@

Method Details

# cannot be a dash. "network": "A String", # URL of the network to which this VPN gateway is attached. Provided by the # client when the VPN gateway is created. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "region": "A String", # Output only. [Output Only] URL of the region where the VPN gateway resides. "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. "stackType": "A String", # The stack type for this VPN gateway to identify the IP protocols that are diff --git a/docs/dyn/compute_v1.vpnTunnels.html b/docs/dyn/compute_v1.vpnTunnels.html index 40ad85a87cb..5e53dc40f96 100644 --- a/docs/dyn/compute_v1.vpnTunnels.html +++ b/docs/dyn/compute_v1.vpnTunnels.html @@ -287,6 +287,25 @@

Method Details

# character must be a lowercase letter, and all following characters must # be a dash, lowercase letter, or digit, except the last character, which # cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is # connected. # Provided by the client when the VPN tunnel is created. @@ -816,6 +835,25 @@

Method Details

# character must be a lowercase letter, and all following characters must # be a dash, lowercase letter, or digit, except the last character, which # cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is # connected. # Provided by the client when the VPN tunnel is created. @@ -974,6 +1012,25 @@

Method Details

# character must be a lowercase letter, and all following characters must # be a dash, lowercase letter, or digit, except the last character, which # cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is # connected. # Provided by the client when the VPN tunnel is created. @@ -1495,6 +1552,25 @@

Method Details

# character must be a lowercase letter, and all following characters must # be a dash, lowercase letter, or digit, except the last character, which # cannot be a dash. + "params": { # Input only. [Input Only] Additional params passed with the request, but not persisted + # as part of resource payload. + "resourceManagerTags": { # Tag keys/values directly bound to this resource. + # Tag keys and values have the same definition as resource + # manager tags. The field is allowed for INSERT + # only. The keys/values to set on the resource should be specified in + # either ID { : } or Namespaced format + # { : }. + # For example the following are valid inputs: + # * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + # * {"123/environment" : "production", "345/abc" : "xyz"} + # Note: + # * Invalid combinations of ID & namespaced format is not supported. For + # instance: {"123/environment" : "tagValues/444"} is invalid. + # * Inconsistent format is not supported. For instance: + # {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + "a_key": "A String", + }, + }, "peerExternalGateway": "A String", # URL of the peer side external VPN gateway to which this VPN tunnel is # connected. # Provided by the client when the VPN tunnel is created. diff --git a/googleapiclient/discovery_cache/documents/compute.alpha.json b/googleapiclient/discovery_cache/documents/compute.alpha.json index 62a96244031..1961d61a1d6 100644 --- a/googleapiclient/discovery_cache/documents/compute.alpha.json +++ b/googleapiclient/discovery_cache/documents/compute.alpha.json @@ -4010,7 +4010,7 @@ ] }, "update": { -"description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask. Only the following fields can be modified: user_license.", +"description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask.", "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.disks.update", @@ -30130,7 +30130,7 @@ ] }, "update": { -"description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask. Only the\nfollowing fields can be modified: user_license.", +"description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask.", "flatPath": "projects/{project}/regions/{region}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.regionDisks.update", @@ -41530,7 +41530,7 @@ "methods": { "get": { "description": "Retrieves information about the specified reservation subBlock.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", "httpMethod": "GET", "id": "compute.reservationSubBlocks.get", "parameterOrder": [ @@ -41543,6 +41543,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41580,7 +41581,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", "response": { "$ref": "ReservationSubBlocksGetResponse" }, @@ -41592,7 +41593,7 @@ }, "getVersion": { "description": "Allows customers to get SBOM versions of a reservation subBlock.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/getVersion", "httpMethod": "POST", "id": "compute.reservationSubBlocks.getVersion", "parameterOrder": [ @@ -41605,6 +41606,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41632,7 +41634,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", "request": { "$ref": "ReservationSubBlocksGetVersionRequest" }, @@ -41646,7 +41648,7 @@ }, "list": { "description": "Retrieves a list of reservation subBlocks under a single reservation.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", "httpMethod": "GET", "id": "compute.reservationSubBlocks.list", "parameterOrder": [ @@ -41681,6 +41683,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41702,7 +41705,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", "response": { "$ref": "ReservationSubBlocksListResponse" }, @@ -41714,7 +41717,7 @@ }, "performMaintenance": { "description": "Allows customers to perform maintenance on a reservation subBlock", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "httpMethod": "POST", "id": "compute.reservationSubBlocks.performMaintenance", "parameterOrder": [ @@ -41727,6 +41730,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41754,7 +41758,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "response": { "$ref": "Operation" }, @@ -41765,7 +41769,7 @@ }, "reportFaulty": { "description": "Allows customers to report a faulty subBlock.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "httpMethod": "POST", "id": "compute.reservationSubBlocks.reportFaulty", "parameterOrder": [ @@ -41778,6 +41782,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41805,7 +41810,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "request": { "$ref": "ReservationSubBlocksReportFaultyRequest" }, @@ -54659,7 +54664,7 @@ } } }, -"revision": "20260206", +"revision": "20260213", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -56570,14 +56575,6 @@ false "" ], "type": "string" -}, -"userLicenses": { -"description": "Output only. [Output Only] A list of user provided licenses. It represents a list of\nURLs to the license resource. Unlike regular licenses, user provided\nlicenses can be modified after the disk is created.", -"items": { -"type": "string" -}, -"readOnly": true, -"type": "array" } }, "type": "object" @@ -56704,7 +56701,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when\nempty.", +"description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when\nempty.", "type": "object" }, "resourcePolicies": { @@ -63758,13 +63755,6 @@ false "description": "URL of the disk type resource describing which disk type to use to create\nthe disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", "type": "string" }, -"userLicenses": { -"description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", -"items": { -"type": "string" -}, -"type": "array" -}, "users": { "description": "Output only. [Output Only] Links to the users of the disk (attached instances)\nin form:projects/project/zones/zone/instances/instance", "items": { @@ -64263,7 +64253,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -74849,13 +74839,6 @@ false "type": "string" }, "type": "array" -}, -"userLicenses": { -"description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", -"items": { -"type": "string" -}, -"type": "array" } }, "type": "object" @@ -75035,7 +75018,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -76971,7 +76954,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", +"description": "Input only. Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", "type": "object" } }, @@ -79518,7 +79501,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -79661,7 +79644,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" }, "resourcePolicies": { @@ -87366,7 +87349,7 @@ false "additionalProperties": { "$ref": "LocationPolicyLocation" }, -"description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.", +"description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.\nThe bulkInsert operation doesn't create instances in an AI zone, even if\nan AI zone is available in the specified region. For example, if you set a\nDENY preference for us-central1-a, Compute Engine will consider\nus-central1-b and us-central1-c for instance creation, but not\nus-central1-ai1a. Also, you can't use the locations[] configuration to\nallow instance creation in an AI zone. To include an AI zone in bulkInsert\noperations, use the locationPolicy.zones[] field.", "type": "object" }, "targetShape": { @@ -87384,7 +87367,7 @@ false "type": "string" }, "zones": { -"description": "List with zones where bulk will create instances.", +"description": "The bulkInsert operation applies any preferences set in the locations\nfield to the specific zones listed in the zones field if the same zones\nare specified in both fields.", "items": { "$ref": "LocationPolicyZoneConfiguration" }, @@ -87440,7 +87423,7 @@ false "id": "LocationPolicyZoneConfiguration", "properties": { "zone": { -"description": "The URL of thezone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid internal URLs,\nsuch as zones/us-central1-a.", +"description": "The URL of the zone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid partial URLs,\nsuch as zones/us-central1-a.", "type": "string" } }, @@ -102348,13 +102331,6 @@ false "type": "string" }, "type": "array" -}, -"userLicenses": { -"description": "[Output Only] A list of user provided licenses represented by a list of\nURLs to the license resource.", -"items": { -"type": "string" -}, -"type": "array" } }, "type": "object" @@ -115375,13 +115351,6 @@ false "type": "string" }, "type": "array" -}, -"userLicenses": { -"description": "[Output Only] A list of user provided licenses represented by a list of\nURLs to the license resource.", -"items": { -"type": "string" -}, -"type": "array" } }, "type": "object" @@ -115848,7 +115817,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -126238,7 +126207,7 @@ false "additionalProperties": { "$ref": "VmExtensionPolicyExtensionPolicy" }, -"description": "Required. A map of extension names (e.g., \"cloudops\") to their corresponding policy\nconfigurations.", +"description": "Required. A map of extension names (for example, \"ops-agent\") to their corresponding\npolicy configurations.", "type": "object" }, "globalResourceLink": { @@ -126281,7 +126250,7 @@ false "type": "string" }, "priority": { -"description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the more recent creation timestamp takes precedence.", +"description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the most recent creation timestamp takes precedence.", "format": "int32", "type": "integer" }, @@ -126738,6 +126707,10 @@ false ], "type": "string" }, +"healthMsg": { +"description": "The health status message of the extension.", +"type": "string" +}, "healthStatus": { "description": "The health status of the extension.", "enum": [ @@ -126766,10 +126739,6 @@ false "description": "The id of the policy that is enforced on the extension.", "type": "string" }, -"unhealthyMsg": { -"description": "The status message of the extension if the extension is in unhealthy\nstate.", -"type": "string" -}, "version": { "description": "The version of the extension.", "type": "string" diff --git a/googleapiclient/discovery_cache/documents/compute.beta.json b/googleapiclient/discovery_cache/documents/compute.beta.json index 083601de2d0..efe62ce1ec3 100644 --- a/googleapiclient/discovery_cache/documents/compute.beta.json +++ b/googleapiclient/discovery_cache/documents/compute.beta.json @@ -3882,7 +3882,7 @@ ] }, "update": { -"description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask. Only the following fields can be modified: user_license.", +"description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask.", "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.disks.update", @@ -9661,6 +9661,54 @@ "https://www.googleapis.com/auth/compute" ] }, +"configureAcceleratorTopologies": { +"description": "Updates the accelerator topologies configuration.", +"flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/configureAcceleratorTopologies", +"httpMethod": "POST", +"id": "compute.instanceGroupManagers.configureAcceleratorTopologies", +"parameterOrder": [ +"project", +"zone", +"instanceGroupManager" +], +"parameters": { +"instanceGroupManager": { +"description": "The name of the managed instance group.\nIt should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +}, +"zone": { +"description": "The name of thezone\nwhere the managed instance group is located.\nIt should conform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/configureAcceleratorTopologies", +"request": { +"$ref": "InstanceGroupManagersConfigureAcceleratorTopologiesRequest" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, "createInstances": { "description": "Creates instances with per-instance configurations in this managed instance\ngroup. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions\ntake additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances\nmethod.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", @@ -27943,7 +27991,7 @@ ] }, "update": { -"description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask. Only the\nfollowing fields can be modified: user_license.", +"description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask.", "flatPath": "projects/{project}/regions/{region}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.regionDisks.update", @@ -38687,7 +38735,7 @@ "methods": { "get": { "description": "Retrieves information about the specified reservation subBlock.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", "httpMethod": "GET", "id": "compute.reservationSubBlocks.get", "parameterOrder": [ @@ -38700,6 +38748,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38737,7 +38786,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", "response": { "$ref": "ReservationSubBlocksGetResponse" }, @@ -38749,7 +38798,7 @@ }, "getIamPolicy": { "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", -"flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/getIamPolicy", "httpMethod": "GET", "id": "compute.reservationSubBlocks.getIamPolicy", "parameterOrder": [ @@ -38794,7 +38843,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/getIamPolicy", "response": { "$ref": "Policy" }, @@ -38806,7 +38855,7 @@ }, "list": { "description": "Retrieves a list of reservation subBlocks under a single reservation.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", "httpMethod": "GET", "id": "compute.reservationSubBlocks.list", "parameterOrder": [ @@ -38841,6 +38890,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38862,7 +38912,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", "response": { "$ref": "ReservationSubBlocksListResponse" }, @@ -38874,7 +38924,7 @@ }, "performMaintenance": { "description": "Allows customers to perform maintenance on a reservation subBlock", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "httpMethod": "POST", "id": "compute.reservationSubBlocks.performMaintenance", "parameterOrder": [ @@ -38887,6 +38937,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38914,7 +38965,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "response": { "$ref": "Operation" }, @@ -38925,7 +38976,7 @@ }, "reportFaulty": { "description": "Allows customers to report a faulty subBlock.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "httpMethod": "POST", "id": "compute.reservationSubBlocks.reportFaulty", "parameterOrder": [ @@ -38938,6 +38989,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38965,7 +39017,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "request": { "$ref": "ReservationSubBlocksReportFaultyRequest" }, @@ -38979,7 +39031,7 @@ }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", -"flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/setIamPolicy", "httpMethod": "POST", "id": "compute.reservationSubBlocks.setIamPolicy", "parameterOrder": [ @@ -39018,7 +39070,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy", "request": { "$ref": "ZoneSetNestedPolicyRequest" }, @@ -39032,7 +39084,7 @@ }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource.", -"flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/testIamPermissions", "httpMethod": "POST", "id": "compute.reservationSubBlocks.testIamPermissions", "parameterOrder": [ @@ -39071,7 +39123,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/testIamPermissions", "request": { "$ref": "TestPermissionsRequest" }, @@ -40570,6 +40622,58 @@ "https://www.googleapis.com/auth/compute" ] }, +"deleteNamedSet": { +"description": "Deletes Named Set", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteNamedSet", +"httpMethod": "POST", +"id": "compute.routers.deleteNamedSet", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"namedSet": { +"description": "The Named Set name for this request. Name must conform to RFC1035", +"location": "query", +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +}, +"router": { +"description": "Name of the Router resource where Named Set is defined.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{router}/deleteNamedSet", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, "deleteRoutePolicy": { "description": "Deletes Route Policy", "flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteRoutePolicy", @@ -40665,6 +40769,53 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, +"getNamedSet": { +"description": "Returns specified Named Set", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/getNamedSet", +"httpMethod": "GET", +"id": "compute.routers.getNamedSet", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"namedSet": { +"description": "The Named Set name for this request. Name must conform to RFC1035", +"location": "query", +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"router": { +"description": "Name of the Router resource to query for the named set. The name should\nconform to RFC1035.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{router}/getNamedSet", +"response": { +"$ref": "RoutersGetNamedSetResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, "getNatIpInfo": { "description": "Retrieves runtime NAT IP information.", "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", @@ -41102,11 +41253,11 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, -"listRoutePolicies": { -"description": "Retrieves a list of router route policy subresources available to the\nspecified project.", -"flatPath": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", +"listNamedSets": { +"description": "Retrieves a list of router named set subresources available to the\nspecified project.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/listNamedSets", "httpMethod": "GET", -"id": "compute.routers.listRoutePolicies", +"id": "compute.routers.listNamedSets", "parameterOrder": [ "project", "region", @@ -41163,9 +41314,9 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", +"path": "projects/{project}/regions/{region}/routers/{router}/listNamedSets", "response": { -"$ref": "RoutersListRoutePolicies" +"$ref": "RoutersListNamedSets" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -41173,17 +41324,40 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, -"patch": { -"description": "Patches the specified Router resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", -"flatPath": "projects/{project}/regions/{region}/routers/{router}", -"httpMethod": "PATCH", -"id": "compute.routers.patch", +"listRoutePolicies": { +"description": "Retrieves a list of router route policy subresources available to the\nspecified project.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", +"httpMethod": "GET", +"id": "compute.routers.listRoutePolicies", "parameterOrder": [ "project", "region", "router" ], "parameters": { +"filter": { +"description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", +"location": "query", +"type": "string" +}, +"maxResults": { +"default": "500", +"description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", +"format": "uint32", +"location": "query", +"minimum": "0", +"type": "integer" +}, +"orderBy": { +"description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", +"location": "query", +"type": "string" +}, +"pageToken": { +"description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", +"location": "query", +"type": "string" +}, "project": { "description": "Project ID for this request.", "location": "path", @@ -41198,36 +41372,34 @@ "required": true, "type": "string" }, -"requestId": { -"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"returnPartialSuccess": { +"description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", "location": "query", -"type": "string" +"type": "boolean" }, "router": { -"description": "Name of the Router resource to patch.", +"description": "Name or id of the resource for this request.\nName should conform to RFC1035.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, -"path": "projects/{project}/regions/{region}/routers/{router}", -"request": { -"$ref": "Router" -}, +"path": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", "response": { -"$ref": "Operation" +"$ref": "RoutersListRoutePolicies" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/compute" +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" ] }, -"patchRoutePolicy": { -"description": "Patches Route Policy", -"flatPath": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", -"httpMethod": "POST", -"id": "compute.routers.patchRoutePolicy", +"patch": { +"description": "Patches the specified Router resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}", +"httpMethod": "PATCH", +"id": "compute.routers.patch", "parameterOrder": [ "project", "region", @@ -41254,16 +41426,16 @@ "type": "string" }, "router": { -"description": "Name of the Router resource where Route Policy is defined.", +"description": "Name of the Router resource to patch.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, -"path": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", +"path": "projects/{project}/regions/{region}/routers/{router}", "request": { -"$ref": "RoutePolicy" +"$ref": "Router" }, "response": { "$ref": "Operation" @@ -41273,11 +41445,11 @@ "https://www.googleapis.com/auth/compute" ] }, -"preview": { -"description": "Preview fields auto-generated during router create andupdate operations.\nCalling this method does NOT create or update the router.", -"flatPath": "projects/{project}/regions/{region}/routers/{router}/preview", +"patchNamedSet": { +"description": "Patches Named Set", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/patchNamedSet", "httpMethod": "POST", -"id": "compute.routers.preview", +"id": "compute.routers.patchNamedSet", "parameterOrder": [ "project", "region", @@ -41298,78 +41470,178 @@ "required": true, "type": "string" }, -"router": { -"description": "Name of the Router resource to query.", -"location": "path", -"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", -"required": true, -"type": "string" -} -}, -"path": "projects/{project}/regions/{region}/routers/{router}/preview", -"request": { -"$ref": "Router" -}, -"response": { -"$ref": "RoutersPreviewResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/compute", -"https://www.googleapis.com/auth/compute.readonly" -] -}, -"testIamPermissions": { -"description": "Returns permissions that a caller has on the specified resource.", -"flatPath": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", -"httpMethod": "POST", -"id": "compute.routers.testIamPermissions", -"parameterOrder": [ -"project", -"region", -"resource" -], -"parameters": { -"project": { -"description": "Project ID for this request.", -"location": "path", -"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", -"required": true, -"type": "string" -}, -"region": { -"description": "The name of the region for this request.", -"location": "path", -"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", -"required": true, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", "type": "string" }, -"resource": { -"description": "Name or id of the resource for this request.", +"router": { +"description": "Name of the Router resource where Named Set is defined.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, -"path": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", +"path": "projects/{project}/regions/{region}/routers/{router}/patchNamedSet", "request": { -"$ref": "TestPermissionsRequest" +"$ref": "NamedSet" }, "response": { -"$ref": "TestPermissionsResponse" +"$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/compute", -"https://www.googleapis.com/auth/compute.readonly" +"https://www.googleapis.com/auth/compute" ] }, -"update": { -"description": "Updates the specified Router resource with the data included in the\nrequest. This method conforms toPUT semantics, which requests that the state of the\ntarget resource be created or replaced with the state defined by the\nrepresentation enclosed in the request message payload.", -"flatPath": "projects/{project}/regions/{region}/routers/{router}", -"httpMethod": "PUT", -"id": "compute.routers.update", +"patchRoutePolicy": { +"description": "Patches Route Policy", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", +"httpMethod": "POST", +"id": "compute.routers.patchRoutePolicy", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +}, +"router": { +"description": "Name of the Router resource where Route Policy is defined.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", +"request": { +"$ref": "RoutePolicy" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"preview": { +"description": "Preview fields auto-generated during router create andupdate operations.\nCalling this method does NOT create or update the router.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/preview", +"httpMethod": "POST", +"id": "compute.routers.preview", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"router": { +"description": "Name of the Router resource to query.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{router}/preview", +"request": { +"$ref": "Router" +}, +"response": { +"$ref": "RoutersPreviewResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"testIamPermissions": { +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.routers.testIamPermissions", +"parameterOrder": [ +"project", +"region", +"resource" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "The name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", +"request": { +"$ref": "TestPermissionsRequest" +}, +"response": { +"$ref": "TestPermissionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"update": { +"description": "Updates the specified Router resource with the data included in the\nrequest. This method conforms toPUT semantics, which requests that the state of the\ntarget resource be created or replaced with the state defined by the\nrepresentation enclosed in the request message payload.", +"flatPath": "projects/{project}/regions/{region}/routers/{router}", +"httpMethod": "PUT", +"id": "compute.routers.update", "parameterOrder": [ "project", "region", @@ -41415,6 +41687,56 @@ "https://www.googleapis.com/auth/compute" ] }, +"updateNamedSet": { +"description": "Updates or creates new Named Set", +"flatPath": "projects/{project}/regions/{region}/routers/{router}/updateNamedSet", +"httpMethod": "POST", +"id": "compute.routers.updateNamedSet", +"parameterOrder": [ +"project", +"region", +"router" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +}, +"router": { +"description": "Name of the Router resource where Named Set is defined.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/routers/{router}/updateNamedSet", +"request": { +"$ref": "NamedSet" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, "updateRoutePolicy": { "description": "Updates or creates new Route Policy", "flatPath": "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy", @@ -42723,15 +43045,55 @@ } } }, -"snapshotSettings": { +"snapshotGroups": { "methods": { +"delete": { +"description": "Deletes the specified SnapshotGroup resource", +"flatPath": "projects/{project}/global/snapshotGroups/{snapshotGroup}", +"httpMethod": "DELETE", +"id": "compute.snapshotGroups.delete", +"parameterOrder": [ +"project", +"snapshotGroup" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +}, +"snapshotGroup": { +"description": "Name of the SnapshotGroup resource to delete.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/snapshotGroups/{snapshotGroup}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, "get": { -"description": "Get snapshot settings.", -"flatPath": "projects/{project}/global/snapshotSettings", +"description": "returns the specified SnapshotGroup resource.", +"flatPath": "projects/{project}/global/snapshotGroups/{snapshotGroup}", "httpMethod": "GET", -"id": "compute.snapshotSettings.get", +"id": "compute.snapshotGroups.get", "parameterOrder": [ -"project" +"project", +"snapshotGroup" ], "parameters": { "project": { @@ -42740,11 +43102,18 @@ "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" +}, +"snapshotGroup": { +"description": "Name of the SnapshotGroup resource to return.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" } }, -"path": "projects/{project}/global/snapshotSettings", +"path": "projects/{project}/global/snapshotGroups/{snapshotGroup}", "response": { -"$ref": "SnapshotSettings" +"$ref": "SnapshotGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -42752,11 +43121,52 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, -"patch": { -"description": "Patch snapshot settings.", -"flatPath": "projects/{project}/global/snapshotSettings", -"httpMethod": "PATCH", -"id": "compute.snapshotSettings.patch", +"getIamPolicy": { +"description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", +"flatPath": "projects/{project}/global/snapshotGroups/{resource}/getIamPolicy", +"httpMethod": "GET", +"id": "compute.snapshotGroups.getIamPolicy", +"parameterOrder": [ +"project", +"resource" +], +"parameters": { +"optionsRequestedPolicyVersion": { +"description": "Requested IAM Policy version.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/snapshotGroups/{resource}/getIamPolicy", +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"description": "Creates a snapshot group in the specified project using the data included\nin the request.", +"flatPath": "projects/{project}/global/snapshotGroups", +"httpMethod": "POST", +"id": "compute.snapshotGroups.insert", "parameterOrder": [ "project" ], @@ -42772,17 +43182,11 @@ "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" -}, -"updateMask": { -"description": "update_mask indicates fields to be updated as part of this request.", -"format": "google-fieldmask", -"location": "query", -"type": "string" } }, -"path": "projects/{project}/global/snapshotSettings", +"path": "projects/{project}/global/snapshotGroups", "request": { -"$ref": "SnapshotSettings" +"$ref": "SnapshotGroup" }, "response": { "$ref": "Operation" @@ -42791,16 +43195,12 @@ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" ] -} -} }, -"snapshots": { -"methods": { -"aggregatedList": { -"description": "Retrieves an aggregated list of all of the snapshots in your project\nacross all regions and global scope.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", -"flatPath": "projects/{project}/aggregated/snapshots", +"list": { +"description": "retrieves the list of SnapshotGroup resources contained within\nthe specified project.", +"flatPath": "projects/{project}/global/snapshotGroups", "httpMethod": "GET", -"id": "compute.snapshots.aggregatedList", +"id": "compute.snapshotGroups.list", "parameterOrder": [ "project" ], @@ -42810,11 +43210,216 @@ "location": "query", "type": "string" }, -"includeAllScopes": { -"description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", -"location": "query", -"type": "boolean" -}, +"maxResults": { +"default": "500", +"description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", +"format": "uint32", +"location": "query", +"minimum": "0", +"type": "integer" +}, +"orderBy": { +"description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", +"location": "query", +"type": "string" +}, +"pageToken": { +"description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", +"location": "query", +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"returnPartialSuccess": { +"description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/global/snapshotGroups", +"response": { +"$ref": "ListSnapshotGroups" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"setIamPolicy": { +"description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", +"flatPath": "projects/{project}/global/snapshotGroups/{resource}/setIamPolicy", +"httpMethod": "POST", +"id": "compute.snapshotGroups.setIamPolicy", +"parameterOrder": [ +"project", +"resource" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/snapshotGroups/{resource}/setIamPolicy", +"request": { +"$ref": "GlobalSetPolicyRequest" +}, +"response": { +"$ref": "Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/global/snapshotGroups/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.snapshotGroups.testIamPermissions", +"parameterOrder": [ +"project", +"resource" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/snapshotGroups/{resource}/testIamPermissions", +"request": { +"$ref": "TestPermissionsRequest" +}, +"response": { +"$ref": "TestPermissionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"snapshotSettings": { +"methods": { +"get": { +"description": "Get snapshot settings.", +"flatPath": "projects/{project}/global/snapshotSettings", +"httpMethod": "GET", +"id": "compute.snapshotSettings.get", +"parameterOrder": [ +"project" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/global/snapshotSettings", +"response": { +"$ref": "SnapshotSettings" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"description": "Patch snapshot settings.", +"flatPath": "projects/{project}/global/snapshotSettings", +"httpMethod": "PATCH", +"id": "compute.snapshotSettings.patch", +"parameterOrder": [ +"project" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +}, +"updateMask": { +"description": "update_mask indicates fields to be updated as part of this request.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/global/snapshotSettings", +"request": { +"$ref": "SnapshotSettings" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +} +} +}, +"snapshots": { +"methods": { +"aggregatedList": { +"description": "Retrieves an aggregated list of all of the snapshots in your project\nacross all regions and global scope.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/snapshots", +"httpMethod": "GET", +"id": "compute.snapshots.aggregatedList", +"parameterOrder": [ +"project" +], +"parameters": { +"filter": { +"description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", +"location": "query", +"type": "string" +}, +"includeAllScopes": { +"description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", +"location": "query", +"type": "boolean" +}, "maxResults": { "default": "500", "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", @@ -50445,7 +51050,7 @@ } } }, -"revision": "20260206", +"revision": "20260213", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -52275,14 +52880,6 @@ false "" ], "type": "string" -}, -"userLicenses": { -"description": "Output only. [Output Only] A list of user provided licenses. It represents a list of\nURLs to the license resource. Unlike regular licenses, user provided\nlicenses can be modified after the disk is created.", -"items": { -"type": "string" -}, -"readOnly": true, -"type": "array" } }, "type": "object" @@ -52386,7 +52983,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when\nempty.", +"description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when\nempty.", "type": "object" }, "resourcePolicies": { @@ -53389,6 +53986,10 @@ false "format": "float", "type": "number" }, +"orchestrationInfo": { +"$ref": "BackendBackendOrchestrationInfo", +"description": "Information about the resource or system that manages the backend." +}, "preference": { "description": "This field indicates whether this backend should be fully utilized before\nsending traffic to backends with default preference. The possible values\nare:\n \n - PREFERRED: Backends with this preference level will be\n filled up to their capacity limits first, based on RTT.\n - DEFAULT: If preferred backends don't have enough\n capacity, backends in this layer would be used and traffic would be\n assigned based on the load balancing algorithm you use. This is the\n default", "enum": [ @@ -53419,6 +54020,17 @@ false }, "type": "object" }, +"BackendBackendOrchestrationInfo": { +"description": "A message containing information about the resource or system that manages\nthe backend.", +"id": "BackendBackendOrchestrationInfo", +"properties": { +"resourceUri": { +"description": "The URI of the resource or system that manages the backend.", +"type": "string" +} +}, +"type": "object" +}, "BackendBucket": { "description": "Represents a Cloud Storage Bucket resource.\n\nThis Cloud Storage bucket resource is referenced by a URL map of a load\nbalancer. For more information, readBackend Buckets.", "id": "BackendBucket", @@ -54542,6 +55154,10 @@ false "$ref": "BackendServiceNetworkPassThroughLbTrafficPolicy", "description": "Configures traffic steering properties of internal passthrough Network\nLoad Balancers.\n\nnetworkPassThroughLbTrafficPolicy cannot be specified with haPolicy." }, +"orchestrationInfo": { +"$ref": "BackendServiceOrchestrationInfo", +"description": "Information about the resource or system that manages the backend service." +}, "outlierDetection": { "$ref": "OutlierDetection", "description": "Settings controlling the ejection of unhealthy backend endpoints from the\nload balancing pool of each individual proxy instance that processes the\ntraffic for the given backend service. If not set, this feature is\nconsidered disabled.\n\nResults of the outlier detection algorithm (ejection of endpoints from the\nload balancing pool and returning them back to the pool) are executed\nindependently by each proxy instance of the load balancer. In most cases,\nmore than one proxy instance handles the traffic received by a backend\nservice. Thus, it is possible that an unhealthy endpoint is detected and\nejected by only some of the proxies, and while this happens, other proxies\nmay continue to send requests to the same unhealthy endpoint until they\ndetect and eject the unhealthy endpoint.\n\nApplicable backend endpoints can be:\n \n - VM instances in an Instance Group\n - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)\n - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)\n - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud\n Functions Services \n - Private Service Connect NEGs, that resolve to\n Google-managed regional API endpoints or managed services published using\n Private Service Connect\n\n\n\nApplicable backend service types can be:\n \n - A global backend service with the loadBalancingScheme set to\n INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. \n - A regional backend\n service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and\n loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not\n supported for Serverless NEGs.\n\n\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true." @@ -55608,6 +56224,17 @@ false }, "type": "object" }, +"BackendServiceOrchestrationInfo": { +"description": "A message containing information about the resource or system that manages\nthe backend service.", +"id": "BackendServiceOrchestrationInfo", +"properties": { +"resourceUri": { +"description": "The resource URI of the resource or system that manages the backend\nservice.", +"type": "string" +} +}, +"type": "object" +}, "BackendServiceParams": { "description": "Additional Backend Service parameters.", "id": "BackendServiceParams", @@ -56206,6 +56833,10 @@ false "$ref": "InstantSnapshotGroupParameters", "description": "The parameters for the instant snapshot group." }, +"snapshotGroupParameters": { +"$ref": "SnapshotGroupParameters", +"description": "The parameters for the snapshot group." +}, "sourceConsistencyGroupPolicy": { "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to clone.\nThis may be a full or partial URL, such as:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n regions/region/resourcePolicies/resourcePolicy", "type": "string" @@ -58672,13 +59303,6 @@ false "description": "URL of the disk type resource describing which disk type to use to create\nthe disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", "type": "string" }, -"userLicenses": { -"description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", -"items": { -"type": "string" -}, -"type": "array" -}, "users": { "description": "Output only. [Output Only] Links to the users of the disk (attached instances)\nin form:projects/project/zones/zone/instances/instance", "items": { @@ -59114,7 +59738,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -67780,13 +68404,6 @@ false "type": "string" }, "type": "array" -}, -"userLicenses": { -"description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", -"items": { -"type": "string" -}, -"type": "array" } }, "type": "object" @@ -67966,7 +68583,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -69774,7 +70391,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", +"description": "Input only. Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", "type": "object" } }, @@ -70657,6 +71274,30 @@ false }, "type": "object" }, +"InstanceGroupManagersConfigureAcceleratorTopologiesRequest": { +"description": "InstanceGroupManagers.ConfigureAcceleratorTopologies", +"id": "InstanceGroupManagersConfigureAcceleratorTopologiesRequest", +"properties": { +"acceleratorTopologyActions": { +"additionalProperties": { +"enum": [ +"ACCELERATOR_TOPOLOGY_ACTION_UNSPECIFIED", +"ACTIVATE", +"DEACTIVATE" +], +"enumDescriptions": [ +"Default value. Should not be used.", +"The accelerator topology is to be activated.", +"The accelerator topology is to be deactivated." +], +"type": "string" +}, +"description": "Map of accelerator topologies that should have their state changed to\nthe specified value. The key is the hashed topology locus id. It can be\nobtained from the GetAvailableAcceleratorTopologies rpc.", +"type": "object" +} +}, +"type": "object" +}, "InstanceGroupManagersCreateInstancesRequest": { "description": "InstanceGroupManagers.createInstances", "id": "InstanceGroupManagersCreateInstancesRequest", @@ -70711,6 +71352,10 @@ false }, "description": "The accelerator topology information returned per id of the topology\nlocation.", "type": "object" +}, +"multiMig": { +"description": "URL to MMIG this MIG belongs to.", +"type": "string" } }, "type": "object" @@ -70726,14 +71371,115 @@ false "enum": [ "DEGRADED", "HEALTHY", -"UNHEALTHY" +"UNHEALTHY", +"UNKNOWN" ], "enumDescriptions": [ "All VM are in RUNNING state, but there is an issue with\nthe inter-chip connectivity that makes this part\nof the infrastructure ready to use as a working\ninter-chip connected group only in a degraded mode.\nThis is allowed only for Instances configured with ICI\nresiliency", "All VM are in RUNNING state, there are no issues with the\ninter-chip connectivity.", -"Some VMs may not be in RUNNING state, or there is an\nissue with the inter-chip connectivity that makes this\npart of the infrastructure unsuitable for forming a\nworking inter-chip connected group." +"Some VMs may not be in RUNNING state, or there is an\nissue with the inter-chip connectivity that makes this\npart of the infrastructure unsuitable for forming a\nworking inter-chip connected group.", +"No signal available" +], +"type": "string" +}, +"acceleratorTopologyState": { +"$ref": "InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState" +}, +"instancesHealth": { +"enum": [ +"ALL_HEALTHY", +"UNHEALTHY_OR_MISSING" +], +"enumDescriptions": [ +"Infrastructure is healthy", +"Some VMs are in another state than RUNNING or they are missing." +], +"type": "string" +}, +"parent": { +"description": "Identified by the topology Id in the accelerator_topology_info map. Empty\nfor the top-level topology", +"type": "string" +} +}, +"type": "object" +}, +"InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState": { +"description": "Specifies the topology state", +"id": "InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState", +"properties": { +"currentState": { +"enum": [ +"ACTIVATING", +"ACTIVE", +"ACTIVE_DEGRADED", +"DEACTIVATING", +"FAILED", +"INACTIVE", +"INCOMPLETE" +], +"enumDescriptions": [ +"", +"", +"The topology is active but with potential performance degradation.", +"", +"Critical non-retriable error that the user has to act manually", +"", +"Not all VMs have been provisioned" ], "type": "string" +}, +"error": { +"description": "Reason why the topology state change failed", +"properties": { +"errors": { +"description": "[Output Only] The array of errors encountered while processing this\noperation.", +"items": { +"properties": { +"code": { +"description": "[Output Only] The error type identifier for this error.", +"type": "string" +}, +"errorDetails": { +"description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", +"items": { +"properties": { +"errorInfo": { +"$ref": "ErrorInfo" +}, +"help": { +"$ref": "Help" +}, +"localizedMessage": { +"$ref": "LocalizedMessage" +}, +"quotaInfo": { +"$ref": "QuotaExceededInfo" +} +}, +"type": "object" +}, +"type": "array" +}, +"location": { +"description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", +"type": "string" +}, +"message": { +"description": "[Output Only] An optional, human-readable error message.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +} +}, +"type": "object" +}, +"errorTimestamp": { +"description": "Timestamp when the last error happened", +"format": "google-datetime", +"type": "string" } }, "type": "object" @@ -72005,7 +72751,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -72140,7 +72886,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" }, "resourcePolicies": { @@ -78479,6 +79225,174 @@ false }, "type": "object" }, +"ListSnapshotGroups": { +"description": "Contains a list of SnapshotGroup resources.", +"id": "ListSnapshotGroups", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of SnapshotGroup resources.", +"items": { +"$ref": "SnapshotGroup" +}, +"type": "array" +}, +"kind": { +"default": "compute#snapshotGroupsList", +"description": "Output only. Type of resource.", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"unreachables": { +"description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed\noperation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as\ndeprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as\nexperimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden.\nDeprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the\nnetwork.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite\nthe mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g:\nregions.list).", +"The user attempted to use a resource that requires a TOS they have not\naccepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, "LocalDisk": { "id": "LocalDisk", "properties": { @@ -78522,7 +79436,7 @@ false "additionalProperties": { "$ref": "LocationPolicyLocation" }, -"description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.", +"description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.\nThe bulkInsert operation doesn't create instances in an AI zone, even if\nan AI zone is available in the specified region. For example, if you set a\nDENY preference for us-central1-a, Compute Engine will consider\nus-central1-b and us-central1-c for instance creation, but not\nus-central1-ai1a. Also, you can't use the locations[] configuration to\nallow instance creation in an AI zone. To include an AI zone in bulkInsert\noperations, use the locationPolicy.zones[] field.", "type": "object" }, "targetShape": { @@ -78538,6 +79452,13 @@ false "GCE prioritizes acquisition of resources, scheduling VMs in zones\nwhere resources are available while distributing VMs as evenly as\npossible across allowed zones to minimize the impact of zonal failure.\nRecommended for highly available serving workloads." ], "type": "string" +}, +"zones": { +"description": "The bulkInsert operation applies any preferences set in the locations\nfield to the specific zones listed in the zones field if the same zones\nare specified in both fields.", +"items": { +"$ref": "LocationPolicyZoneConfiguration" +}, +"type": "array" } }, "type": "object" @@ -78578,6 +79499,16 @@ false }, "type": "object" }, +"LocationPolicyZoneConfiguration": { +"id": "LocationPolicyZoneConfiguration", +"properties": { +"zone": { +"description": "The URL of the zone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid partial URLs,\nsuch as zones/us-central1-a.", +"type": "string" +} +}, +"type": "object" +}, "MachineImage": { "description": "Represents a machine image resource.\n\nA machine image is a Compute Engine resource that stores all the\nconfiguration, metadata, permissions, and data from one or more disks\nrequired to create a Virtual machine (VM) instance. For more information, seeMachine images.", "id": "MachineImage", @@ -80420,6 +81351,44 @@ false }, "type": "object" }, +"NamedSet": { +"id": "NamedSet", +"properties": { +"description": { +"description": "An optional description of named set.", +"type": "string" +}, +"elements": { +"description": "CEL expressions that are comparable to constructs of this set's type\n(see Policy Language).", +"items": { +"$ref": "Expr" +}, +"type": "array" +}, +"fingerprint": { +"description": "A fingerprint for the Named Set being applied to this Router, which is\nessentially a hash of the Named Set used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes\nafter every request to modify or update the Named Set. You must always\nprovide an up-to-date fingerprint hash in order to update or change\nlabels.\n\nTo see the latest fingerprint, make a getNamedSet() request\nto retrieve a Named Set.", +"format": "byte", +"type": "string" +}, +"name": { +"description": "This set's name, which must be a resource ID segment and unique within all\nnamed sets owned by the Router. Name should conform to RFC1035.", +"type": "string" +}, +"type": { +"description": "This named set's type", +"enum": [ +"NAMED_SET_TYPE_COMMUNITY", +"NAMED_SET_TYPE_PREFIX" +], +"enumDescriptions": [ +"The Named Set is a Community Named Set.", +"The Named Set is a Prefix Named Set." +], +"type": "string" +} +}, +"type": "object" +}, "NatIpInfo": { "description": "Contains NAT IP information of a NAT config (i.e. usage status, mode).", "id": "NatIpInfo", @@ -93347,6 +94316,10 @@ false "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, +"params": { +"$ref": "ReservationParams", +"description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." +}, "protectionTier": { "description": "Protection tier for the workload which specifies the workload expectations\nin the event of infrastructure failures at data center (e.g. power\nand/or cooling failures).", "enum": [ @@ -94195,6 +95168,20 @@ false }, "type": "object" }, +"ReservationParams": { +"description": "Additional reservation params.", +"id": "ReservationParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the reservation. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"type": "object" +} +}, +"type": "object" +}, "ReservationSlot": { "description": "Represents a reservation slot resource.", "id": "ReservationSlot", @@ -94247,13 +95234,15 @@ false "ACTIVE", "CREATING", "DELETING", -"STATE_UNSPECIFIED" +"STATE_UNSPECIFIED", +"UNAVAILABLE" ], "enumDescriptions": [ "The reservation slot has allocated all its resources.", "The resources are being allocated for the reservation slot.", "The reservation slot is currently being deleted.", -"" +"", +"The reservation slot is currently unavailable." ], "readOnly": true, "type": "string" @@ -98981,6 +99970,19 @@ false }, "type": "object" }, +"RoutersGetNamedSetResponse": { +"id": "RoutersGetNamedSetResponse", +"properties": { +"etag": { +"description": "end_interface: MixerGetResponseWithEtagBuilder", +"type": "string" +}, +"resource": { +"$ref": "NamedSet" +} +}, +"type": "object" +}, "RoutersGetRoutePolicyResponse": { "id": "RoutersGetRoutePolicyResponse", "properties": { @@ -99157,6 +100159,173 @@ false }, "type": "object" }, +"RoutersListNamedSets": { +"id": "RoutersListNamedSets", +"properties": { +"etag": { +"type": "string" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"type": "string" +}, +"kind": { +"default": "compute#routersListNamedSets", +"description": "Output only. [Output Only] Type of resource. Alwayscompute#routersListNamedSets for lists of named sets.", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", +"type": "string" +}, +"result": { +"description": "[Output Only] A list of named sets.", +"items": { +"$ref": "NamedSet" +}, +"type": "array" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"unreachables": { +"description": "Output only. [Output Only] Unreachable resources.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed\noperation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as\ndeprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as\nexperimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden.\nDeprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the\nnetwork.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite\nthe mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g:\nregions.list).", +"The user attempted to use a resource that requires a TOS they have not\naccepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, "RoutersListRoutePolicies": { "id": "RoutersListRoutePolicies", "properties": { @@ -102683,6 +103852,16 @@ false "$ref": "CustomerEncryptionKey", "description": "Encrypts the snapshot using acustomer-supplied\nencryption key.\n\nAfter you encrypt a snapshot using a customer-supplied key, you must\nprovide the same key if you use the snapshot later. For example, you must\nprovide the encryption key when you create a disk from the encrypted\nsnapshot in a future request.\n\nCustomer-supplied encryption keys do not protect access to metadata\nof the snapshot.\n\nIf you do not provide an encryption key when creating the snapshot, then\nthe snapshot will be encrypted using an automatically generated key and you\ndo not need to provide a key to use the snapshot later." }, +"snapshotGroupId": { +"description": "Output only. [Output Only] The unique ID of the snapshot group that this snapshot\nbelongs to.", +"readOnly": true, +"type": "string" +}, +"snapshotGroupName": { +"description": "Output only. [Output only] The snapshot group that this snapshot belongs to.", +"readOnly": true, +"type": "string" +}, "snapshotType": { "description": "Indicates the type of the snapshot.", "enum": [ @@ -102779,13 +103958,6 @@ false "type": "string" }, "type": "array" -}, -"userLicenses": { -"description": "[Output Only] A list of user provided licenses represented by a list of\nURLs to the license resource.", -"items": { -"type": "string" -}, -"type": "array" } }, "type": "object" @@ -102958,6 +104130,135 @@ false }, "type": "object" }, +"SnapshotGroup": { +"description": "Represents a SnapshotGroup resource.\n\nA snapshot group is a set of snapshots that represents a point in time state\nof a consistency group.", +"id": "SnapshotGroup", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Optional. An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#snapshotGroup", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#snapshotGroup for SnapshotGroup\nresources.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Identifier. Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +}, +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", +"readOnly": true, +"type": "string" +}, +"sourceInfo": { +"$ref": "SnapshotGroupSourceInfo", +"description": "Output only. [Output Only]", +"readOnly": true +}, +"sourceInstantSnapshotGroup": { +"description": "Input field for the source instant snapshot group.", +"type": "string" +}, +"sourceInstantSnapshotGroupInfo": { +"$ref": "SnapshotGroupSourceInstantSnapshotGroupInfo", +"description": "Output only. [Output Only]", +"readOnly": true +}, +"status": { +"description": "Output only. [Output Only]", +"enum": [ +"CREATING", +"DELETING", +"FAILED", +"INVALID", +"READY", +"UNKNOWN", +"UPLOADING" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"" +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"SnapshotGroupParameters": { +"id": "SnapshotGroupParameters", +"properties": { +"replicaZones": { +"description": "URLs of the zones where disks should be replicated to. Only applicable\nfor regional resources.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sourceSnapshotGroup": { +"description": "The source snapshot group used to create disks. You can provide this as a\npartial or full URL to the resource. For example, the following are valid\nvalues:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup \n - projects/project/global/snapshotGroups/snapshotGroup\n - global/snapshotGroups/snapshotGroup", +"type": "string" +}, +"type": { +"description": "URL of the disk type resource describing which disk type to use to create\ndisks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", +"type": "string" +} +}, +"type": "object" +}, +"SnapshotGroupSourceInfo": { +"id": "SnapshotGroupSourceInfo", +"properties": { +"consistencyGroup": { +"readOnly": true, +"type": "string" +}, +"consistencyGroupId": { +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"SnapshotGroupSourceInstantSnapshotGroupInfo": { +"id": "SnapshotGroupSourceInstantSnapshotGroupInfo", +"properties": { +"instantSnapshotGroup": { +"readOnly": true, +"type": "string" +}, +"instantSnapshotGroupId": { +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "SnapshotList": { "description": "Contains a list of Snapshot resources.", "id": "SnapshotList", @@ -103123,7 +104424,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -113106,7 +114407,7 @@ false "additionalProperties": { "$ref": "VmExtensionPolicyExtensionPolicy" }, -"description": "Required. A map of extension names (e.g., \"cloudops\") to their corresponding policy\nconfigurations.", +"description": "Required. A map of extension names (for example, \"ops-agent\") to their corresponding\npolicy configurations.", "type": "object" }, "globalResourceLink": { @@ -113149,7 +114450,7 @@ false "type": "string" }, "priority": { -"description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the more recent creation timestamp takes precedence.", +"description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the most recent creation timestamp takes precedence.", "format": "int32", "type": "integer" }, diff --git a/googleapiclient/discovery_cache/documents/compute.v1.json b/googleapiclient/discovery_cache/documents/compute.v1.json index b9a8cc3d659..66fa83b9e22 100644 --- a/googleapiclient/discovery_cache/documents/compute.v1.json +++ b/googleapiclient/discovery_cache/documents/compute.v1.json @@ -3671,7 +3671,7 @@ ] }, "update": { -"description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask. Only the following fields can be modified: user_license.", +"description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask.", "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.disks.update", @@ -25122,7 +25122,7 @@ ] }, "update": { -"description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask. Only the\nfollowing fields can be modified: user_license.", +"description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask.", "flatPath": "projects/{project}/regions/{region}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.regionDisks.update", @@ -25184,22 +25184,89 @@ } } }, -"regionHealthCheckServices": { +"regionHealthAggregationPolicies": { "methods": { +"aggregatedList": { +"description": "Retrieves the list of all HealthAggregationPolicy resources,\nregional and global, available to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", +"flatPath": "projects/{project}/aggregated/healthAggregationPolicies", +"httpMethod": "GET", +"id": "compute.regionHealthAggregationPolicies.aggregatedList", +"parameterOrder": [ +"project" +], +"parameters": { +"filter": { +"description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", +"location": "query", +"type": "string" +}, +"includeAllScopes": { +"description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", +"location": "query", +"type": "boolean" +}, +"maxResults": { +"default": "500", +"description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", +"format": "uint32", +"location": "query", +"minimum": "0", +"type": "integer" +}, +"orderBy": { +"description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", +"location": "query", +"type": "string" +}, +"pageToken": { +"description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", +"location": "query", +"type": "string" +}, +"project": { +"description": "Name of the project scoping this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"returnPartialSuccess": { +"description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", +"location": "query", +"type": "boolean" +}, +"serviceProjectNumber": { +"description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", +"format": "int64", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/aggregated/healthAggregationPolicies", +"response": { +"$ref": "HealthAggregationPolicyAggregatedList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, "delete": { -"description": "Deletes the specified regional HealthCheckService.", -"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"description": "Deletes the specified HealthAggregationPolicy in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "httpMethod": "DELETE", -"id": "compute.regionHealthCheckServices.delete", +"id": "compute.regionHealthAggregationPolicies.delete", "parameterOrder": [ "project", "region", -"healthCheckService" +"healthAggregationPolicy" ], "parameters": { -"healthCheckService": { -"description": "Name of the HealthCheckService to delete. The name\nmust be 1-63 characters long, and comply with RFC1035.", +"healthAggregationPolicy": { +"description": "Name of the HealthAggregationPolicy resource to delete.", "location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25223,7 +25290,7 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "response": { "$ref": "Operation" }, @@ -25233,19 +25300,20 @@ ] }, "get": { -"description": "Returns the specified regional HealthCheckService resource.", -"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"description": "Returns the specified HealthAggregationPolicy resource in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "httpMethod": "GET", -"id": "compute.regionHealthCheckServices.get", +"id": "compute.regionHealthAggregationPolicies.get", "parameterOrder": [ "project", "region", -"healthCheckService" +"healthAggregationPolicy" ], "parameters": { -"healthCheckService": { -"description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", +"healthAggregationPolicy": { +"description": "Name of the HealthAggregationPolicy resource to return.", "location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25264,9 +25332,9 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "response": { -"$ref": "HealthCheckService" +"$ref": "HealthAggregationPolicy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25275,10 +25343,10 @@ ] }, "insert": { -"description": "Creates a regional HealthCheckService resource in the\nspecified project and region using the data included in the request.", -"flatPath": "projects/{project}/regions/{region}/healthCheckServices", +"description": "Create a HealthAggregationPolicy in the specified project in the given\nregion using the parameters that are included in the request.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies", "httpMethod": "POST", -"id": "compute.regionHealthCheckServices.insert", +"id": "compute.regionHealthAggregationPolicies.insert", "parameterOrder": [ "project", "region" @@ -25304,9 +25372,9 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthCheckServices", +"path": "projects/{project}/regions/{region}/healthAggregationPolicies", "request": { -"$ref": "HealthCheckService" +"$ref": "HealthAggregationPolicy" }, "response": { "$ref": "Operation" @@ -25317,10 +25385,10 @@ ] }, "list": { -"description": "Lists all the HealthCheckService resources that have been\nconfigured for the specified project in the given region.", -"flatPath": "projects/{project}/regions/{region}/healthCheckServices", +"description": "Lists the HealthAggregationPolicies for a project in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies", "httpMethod": "GET", -"id": "compute.regionHealthCheckServices.list", +"id": "compute.regionHealthAggregationPolicies.list", "parameterOrder": [ "project", "region" @@ -25369,9 +25437,9 @@ "type": "boolean" } }, -"path": "projects/{project}/regions/{region}/healthCheckServices", +"path": "projects/{project}/regions/{region}/healthAggregationPolicies", "response": { -"$ref": "HealthCheckServicesList" +"$ref": "HealthAggregationPolicyList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25380,18 +25448,18 @@ ] }, "patch": { -"description": "Updates the specified regional HealthCheckService resource\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", -"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"description": "Updates the specified regional HealthAggregationPolicy\nresource with the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "httpMethod": "PATCH", -"id": "compute.regionHealthCheckServices.patch", +"id": "compute.regionHealthAggregationPolicies.patch", "parameterOrder": [ "project", "region", -"healthCheckService" +"healthAggregationPolicy" ], "parameters": { -"healthCheckService": { -"description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", +"healthAggregationPolicy": { +"description": "Name of the HealthAggregationPolicy to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", "location": "path", "required": true, "type": "string" @@ -25416,9 +25484,9 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "request": { -"$ref": "HealthCheckService" +"$ref": "HealthAggregationPolicy" }, "response": { "$ref": "Operation" @@ -25430,9 +25498,9 @@ }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource.", -"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", +"flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions", "httpMethod": "POST", -"id": "compute.regionHealthCheckServices.testIamPermissions", +"id": "compute.regionHealthAggregationPolicies.testIamPermissions", "parameterOrder": [ "project", "region", @@ -25461,7 +25529,7 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", +"path": "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions", "request": { "$ref": "TestPermissionsRequest" }, @@ -25476,23 +25544,22 @@ } } }, -"regionHealthChecks": { +"regionHealthCheckServices": { "methods": { "delete": { -"description": "Deletes the specified HealthCheck resource.", -"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"description": "Deletes the specified regional HealthCheckService.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "httpMethod": "DELETE", -"id": "compute.regionHealthChecks.delete", +"id": "compute.regionHealthCheckServices.delete", "parameterOrder": [ "project", "region", -"healthCheck" +"healthCheckService" ], "parameters": { -"healthCheck": { -"description": "Name of the HealthCheck resource to delete.", +"healthCheckService": { +"description": "Name of the HealthCheckService to delete. The name\nmust be 1-63 characters long, and comply with RFC1035.", "location": "path", -"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25516,7 +25583,7 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "response": { "$ref": "Operation" }, @@ -25526,20 +25593,19 @@ ] }, "get": { -"description": "Returns the specified HealthCheck resource.", -"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"description": "Returns the specified regional HealthCheckService resource.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "httpMethod": "GET", -"id": "compute.regionHealthChecks.get", +"id": "compute.regionHealthCheckServices.get", "parameterOrder": [ "project", "region", -"healthCheck" +"healthCheckService" ], "parameters": { -"healthCheck": { -"description": "Name of the HealthCheck resource to return.", +"healthCheckService": { +"description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", "location": "path", -"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25558,9 +25624,9 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "response": { -"$ref": "HealthCheck" +"$ref": "HealthCheckService" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25569,10 +25635,10 @@ ] }, "insert": { -"description": "Creates a HealthCheck resource in the specified project using the data\nincluded in the request.", -"flatPath": "projects/{project}/regions/{region}/healthChecks", +"description": "Creates a regional HealthCheckService resource in the\nspecified project and region using the data included in the request.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices", "httpMethod": "POST", -"id": "compute.regionHealthChecks.insert", +"id": "compute.regionHealthCheckServices.insert", "parameterOrder": [ "project", "region" @@ -25598,9 +25664,9 @@ "type": "string" } }, -"path": "projects/{project}/regions/{region}/healthChecks", +"path": "projects/{project}/regions/{region}/healthCheckServices", "request": { -"$ref": "HealthCheck" +"$ref": "HealthCheckService" }, "response": { "$ref": "Operation" @@ -25611,10 +25677,10 @@ ] }, "list": { -"description": "Retrieves the list of HealthCheck resources available to the specified\nproject.", -"flatPath": "projects/{project}/regions/{region}/healthChecks", +"description": "Lists all the HealthCheckService resources that have been\nconfigured for the specified project in the given region.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices", "httpMethod": "GET", -"id": "compute.regionHealthChecks.list", +"id": "compute.regionHealthCheckServices.list", "parameterOrder": [ "project", "region" @@ -25663,9 +25729,9 @@ "type": "boolean" } }, -"path": "projects/{project}/regions/{region}/healthChecks", +"path": "projects/{project}/regions/{region}/healthCheckServices", "response": { -"$ref": "HealthCheckList" +"$ref": "HealthCheckServicesList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25674,10 +25740,109 @@ ] }, "patch": { -"description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", -"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"description": "Updates the specified regional HealthCheckService resource\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "httpMethod": "PATCH", -"id": "compute.regionHealthChecks.patch", +"id": "compute.regionHealthCheckServices.patch", +"parameterOrder": [ +"project", +"region", +"healthCheckService" +], +"parameters": { +"healthCheckService": { +"description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", +"location": "path", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", +"request": { +"$ref": "HealthCheckService" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"testIamPermissions": { +"description": "Returns permissions that a caller has on the specified resource.", +"flatPath": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", +"httpMethod": "POST", +"id": "compute.regionHealthCheckServices.testIamPermissions", +"parameterOrder": [ +"project", +"region", +"resource" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "The name of the region for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"resource": { +"description": "Name or id of the resource for this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", +"request": { +"$ref": "TestPermissionsRequest" +}, +"response": { +"$ref": "TestPermissionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +} +} +}, +"regionHealthChecks": { +"methods": { +"delete": { +"description": "Deletes the specified HealthCheck resource.", +"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"httpMethod": "DELETE", +"id": "compute.regionHealthChecks.delete", "parameterOrder": [ "project", "region", @@ -25685,7 +25850,202 @@ ], "parameters": { "healthCheck": { -"description": "Name of the HealthCheck resource to patch.", +"description": "Name of the HealthCheck resource to delete.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"get": { +"description": "Returns the specified HealthCheck resource.", +"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"httpMethod": "GET", +"id": "compute.regionHealthChecks.get", +"parameterOrder": [ +"project", +"region", +"healthCheck" +], +"parameters": { +"healthCheck": { +"description": "Name of the HealthCheck resource to return.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", +"required": true, +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"response": { +"$ref": "HealthCheck" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"insert": { +"description": "Creates a HealthCheck resource in the specified project using the data\nincluded in the request.", +"flatPath": "projects/{project}/regions/{region}/healthChecks", +"httpMethod": "POST", +"id": "compute.regionHealthChecks.insert", +"parameterOrder": [ +"project", +"region" +], +"parameters": { +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"requestId": { +"description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", +"location": "query", +"type": "string" +} +}, +"path": "projects/{project}/regions/{region}/healthChecks", +"request": { +"$ref": "HealthCheck" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute" +] +}, +"list": { +"description": "Retrieves the list of HealthCheck resources available to the specified\nproject.", +"flatPath": "projects/{project}/regions/{region}/healthChecks", +"httpMethod": "GET", +"id": "compute.regionHealthChecks.list", +"parameterOrder": [ +"project", +"region" +], +"parameters": { +"filter": { +"description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", +"location": "query", +"type": "string" +}, +"maxResults": { +"default": "500", +"description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", +"format": "uint32", +"location": "query", +"minimum": "0", +"type": "integer" +}, +"orderBy": { +"description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", +"location": "query", +"type": "string" +}, +"pageToken": { +"description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", +"location": "query", +"type": "string" +}, +"project": { +"description": "Project ID for this request.", +"location": "path", +"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", +"required": true, +"type": "string" +}, +"region": { +"description": "Name of the region scoping this request.", +"location": "path", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"required": true, +"type": "string" +}, +"returnPartialSuccess": { +"description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", +"location": "query", +"type": "boolean" +} +}, +"path": "projects/{project}/regions/{region}/healthChecks", +"response": { +"$ref": "HealthCheckList" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/compute", +"https://www.googleapis.com/auth/compute.readonly" +] +}, +"patch": { +"description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", +"flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", +"httpMethod": "PATCH", +"id": "compute.regionHealthChecks.patch", +"parameterOrder": [ +"project", +"region", +"healthCheck" +], +"parameters": { +"healthCheck": { +"description": "Name of the HealthCheck resource to patch.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, @@ -32407,7 +32767,7 @@ "methods": { "get": { "description": "Retrieves information about the specified reservation subBlock.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", "httpMethod": "GET", "id": "compute.reservationSubBlocks.get", "parameterOrder": [ @@ -32420,6 +32780,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32457,7 +32818,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", "response": { "$ref": "ReservationSubBlocksGetResponse" }, @@ -32469,7 +32830,7 @@ }, "getIamPolicy": { "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", -"flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/getIamPolicy", "httpMethod": "GET", "id": "compute.reservationSubBlocks.getIamPolicy", "parameterOrder": [ @@ -32514,7 +32875,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/getIamPolicy", "response": { "$ref": "Policy" }, @@ -32526,7 +32887,7 @@ }, "list": { "description": "Retrieves a list of reservation subBlocks under a single reservation.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", "httpMethod": "GET", "id": "compute.reservationSubBlocks.list", "parameterOrder": [ @@ -32561,6 +32922,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32582,7 +32944,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", "response": { "$ref": "ReservationSubBlocksListResponse" }, @@ -32594,7 +32956,7 @@ }, "performMaintenance": { "description": "Allows customers to perform maintenance on a reservation subBlock", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "httpMethod": "POST", "id": "compute.reservationSubBlocks.performMaintenance", "parameterOrder": [ @@ -32607,6 +32969,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32634,7 +32997,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "response": { "$ref": "Operation" }, @@ -32645,7 +33008,7 @@ }, "reportFaulty": { "description": "Allows customers to report a faulty subBlock.", -"flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "httpMethod": "POST", "id": "compute.reservationSubBlocks.reportFaulty", "parameterOrder": [ @@ -32658,6 +33021,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", +"pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32685,7 +33049,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", +"path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "request": { "$ref": "ReservationSubBlocksReportFaultyRequest" }, @@ -32699,7 +33063,7 @@ }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", -"flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/setIamPolicy", "httpMethod": "POST", "id": "compute.reservationSubBlocks.setIamPolicy", "parameterOrder": [ @@ -32738,7 +33102,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy", "request": { "$ref": "ZoneSetNestedPolicyRequest" }, @@ -32752,7 +33116,7 @@ }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource.", -"flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", +"flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/testIamPermissions", "httpMethod": "POST", "id": "compute.reservationSubBlocks.testIamPermissions", "parameterOrder": [ @@ -32791,7 +33155,7 @@ "type": "string" } }, -"path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", +"path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/testIamPermissions", "request": { "$ref": "TestPermissionsRequest" }, @@ -43142,7 +43506,7 @@ } } }, -"revision": "20260206", +"revision": "20260213", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -45023,7 +45387,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when\nempty.", +"description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when\nempty.", "type": "object" }, "resourcePolicies": { @@ -45984,6 +46348,10 @@ false "format": "float", "type": "number" }, +"orchestrationInfo": { +"$ref": "BackendBackendOrchestrationInfo", +"description": "Information about the resource or system that manages the backend." +}, "preference": { "description": "This field indicates whether this backend should be fully utilized before\nsending traffic to backends with default preference. The possible values\nare:\n \n - PREFERRED: Backends with this preference level will be\n filled up to their capacity limits first, based on RTT.\n - DEFAULT: If preferred backends don't have enough\n capacity, backends in this layer would be used and traffic would be\n assigned based on the load balancing algorithm you use. This is the\n default", "enum": [ @@ -46001,6 +46369,17 @@ false }, "type": "object" }, +"BackendBackendOrchestrationInfo": { +"description": "A message containing information about the resource or system that manages\nthe backend.", +"id": "BackendBackendOrchestrationInfo", +"properties": { +"resourceUri": { +"description": "The URI of the resource or system that manages the backend.", +"type": "string" +} +}, +"type": "object" +}, "BackendBucket": { "description": "Represents a Cloud Storage Bucket resource.\n\nThis Cloud Storage bucket resource is referenced by a URL map of a load\nbalancer. For more information, readBackend Buckets.", "id": "BackendBucket", @@ -46663,6 +47042,10 @@ false "$ref": "BackendServiceNetworkPassThroughLbTrafficPolicy", "description": "Configures traffic steering properties of internal passthrough Network\nLoad Balancers.\n\nnetworkPassThroughLbTrafficPolicy cannot be specified with haPolicy." }, +"orchestrationInfo": { +"$ref": "BackendServiceOrchestrationInfo", +"description": "Information about the resource or system that manages the backend service." +}, "outlierDetection": { "$ref": "OutlierDetection", "description": "Settings controlling the ejection of unhealthy backend endpoints from the\nload balancing pool of each individual proxy instance that processes the\ntraffic for the given backend service. If not set, this feature is\nconsidered disabled.\n\nResults of the outlier detection algorithm (ejection of endpoints from the\nload balancing pool and returning them back to the pool) are executed\nindependently by each proxy instance of the load balancer. In most cases,\nmore than one proxy instance handles the traffic received by a backend\nservice. Thus, it is possible that an unhealthy endpoint is detected and\nejected by only some of the proxies, and while this happens, other proxies\nmay continue to send requests to the same unhealthy endpoint until they\ndetect and eject the unhealthy endpoint.\n\nApplicable backend endpoints can be:\n \n - VM instances in an Instance Group\n - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)\n - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)\n - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud\n Functions Services \n - Private Service Connect NEGs, that resolve to\n Google-managed regional API endpoints or managed services published using\n Private Service Connect\n\n\n\nApplicable backend service types can be:\n \n - A global backend service with the loadBalancingScheme set to\n INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. \n - A regional backend\n service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and\n loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not\n supported for Serverless NEGs.\n\n\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true." @@ -47707,6 +48090,17 @@ false }, "type": "object" }, +"BackendServiceOrchestrationInfo": { +"description": "A message containing information about the resource or system that manages\nthe backend service.", +"id": "BackendServiceOrchestrationInfo", +"properties": { +"resourceUri": { +"description": "The resource URI of the resource or system that manages the backend\nservice.", +"type": "string" +} +}, +"type": "object" +}, "BackendServiceParams": { "description": "Additional Backend Service parameters.", "id": "BackendServiceParams", @@ -50489,7 +50883,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -51610,6 +52004,10 @@ false "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, +"params": { +"$ref": "ExternalVpnGatewayParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, "redundancyType": { "description": "Indicates the user-supplied redundancy type of this external VPN gateway.", "enum": [ @@ -51812,6 +52210,19 @@ false }, "type": "object" }, +"ExternalVpnGatewayParams": { +"id": "ExternalVpnGatewayParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "FileContentBuffer": { "id": "FileContentBuffer", "properties": { @@ -55378,155 +55789,18 @@ false }, "type": "object" }, -"HealthCheck": { -"description": "Represents a health check resource.\n\nGoogle Compute Engine has two health check resources:\n\n* [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)\n* [Global](/compute/docs/reference/rest/v1/healthChecks)\n\nThese health check resources can be used for load balancing and for\nautohealing VMs in a managed instance group (MIG).\n\n**Load balancing**\n\nHealth check requirements vary depending on the type of load balancer. For\ndetails about the type of health check supported for\neach load balancer and corresponding backend type,\nsee Health\nchecks overview: Load balancer guide.\n\n**Autohealing in MIGs**\n\nThe health checks that you use for autohealing VMs in a MIG can be either\nregional or global. For more information, see Set up an\napplication health check and autohealing.\n\nFor more information, seeHealth checks\noverview.", -"id": "HealthCheck", +"HealthAggregationPoliciesScopedList": { +"id": "HealthAggregationPoliciesScopedList", "properties": { -"checkIntervalSec": { -"description": "How often (in seconds) to send a health check. The default value is 5\nseconds.", -"format": "int32", -"type": "integer" -}, -"creationTimestamp": { -"description": "Output only. [Output Only] Creation timestamp in3339\ntext format.", -"readOnly": true, -"type": "string" -}, -"description": { -"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", -"type": "string" -}, -"grpcHealthCheck": { -"$ref": "GRPCHealthCheck" -}, -"grpcTlsHealthCheck": { -"$ref": "GRPCTLSHealthCheck" -}, -"healthyThreshold": { -"description": "A so-far unhealthy instance will be marked healthy after this\nmany consecutive successes. The default value is 2.", -"format": "int32", -"type": "integer" -}, -"http2HealthCheck": { -"$ref": "HTTP2HealthCheck" -}, -"httpHealthCheck": { -"$ref": "HTTPHealthCheck" -}, -"httpsHealthCheck": { -"$ref": "HTTPSHealthCheck" -}, -"id": { -"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", -"format": "uint64", -"type": "string" -}, -"kind": { -"default": "compute#healthCheck", -"description": "Output only. Type of the resource.", -"readOnly": true, -"type": "string" -}, -"logConfig": { -"$ref": "HealthCheckLogConfig", -"description": "Configure logging on this health check." -}, -"name": { -"description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nFor example, a name that is 1-63 characters long, matches the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with\nRFC1035. This regular expression describes a name where the first\ncharacter is a lowercase letter, and all following characters are a dash,\nlowercase letter, or digit, except the last character, which isn't a dash.", -"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", -"type": "string" -}, -"region": { -"description": "Output only. [Output Only] Region where the health check resides. Not applicable to\nglobal health checks.", -"readOnly": true, -"type": "string" -}, -"selfLink": { -"description": "[Output Only] Server-defined URL for the resource.", -"type": "string" -}, -"sourceRegions": { -"description": "The list of cloud regions from which health checks are performed. If any\nregions are specified, then exactly 3 regions should be specified. The\nregion names must be valid names of Google Cloud regions.\nThis can only be set for global health check.\nIf this list is non-empty, then there are restrictions\non what other health check fields are supported and what other resources\ncan use this health check:\n \n - SSL, HTTP2, and GRPC protocols are not supported.\n - The TCP request field is not supported.\n - The proxyHeader field for HTTP, HTTPS, and TCP is not\n supported.\n - The checkIntervalSec field must be at least 30.\n - The health check cannot be used with BackendService nor with managed\n instance group auto-healing.", +"healthAggregationPolicies": { +"description": "A list of HealthAggregationPolicys contained in this scope.", "items": { -"type": "string" +"$ref": "HealthAggregationPolicy" }, "type": "array" }, -"sslHealthCheck": { -"$ref": "SSLHealthCheck" -}, -"tcpHealthCheck": { -"$ref": "TCPHealthCheck" -}, -"timeoutSec": { -"description": "How long (in seconds) to wait before claiming failure. The default value is\n5 seconds. It is invalid for timeoutSec to have greater\nvalue than checkIntervalSec.", -"format": "int32", -"type": "integer" -}, -"type": { -"description": "Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the\nprotocol-specific health check fields must be specified, which must matchtype field.", -"enum": [ -"GRPC", -"GRPC_WITH_TLS", -"HTTP", -"HTTP2", -"HTTPS", -"INVALID", -"SSL", -"TCP" -], -"enumDescriptions": [ -"", -"", -"", -"", -"", -"", -"", -"" -], -"type": "string" -}, -"unhealthyThreshold": { -"description": "A so-far healthy instance will be marked unhealthy after this many\nconsecutive failures. The default value is 2.", -"format": "int32", -"type": "integer" -} -}, -"type": "object" -}, -"HealthCheckList": { -"description": "Contains a list of HealthCheck resources.", -"id": "HealthCheckList", -"properties": { -"id": { -"description": "[Output Only] Unique identifier for the resource; defined by the server.", -"type": "string" -}, -"items": { -"description": "A list of HealthCheck resources.", -"items": { -"$ref": "HealthCheck" -}, -"type": "array" -}, -"kind": { -"default": "compute#healthCheckList", -"description": "Output only. Type of resource.", -"readOnly": true, -"type": "string" -}, -"nextPageToken": { -"description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", -"type": "string" -}, -"selfLink": { -"description": "Output only. [Output Only] Server-defined URL for this resource.", -"readOnly": true, -"type": "string" -}, "warning": { -"description": "[Output Only] Informational warning message.", +"description": "Informational warning which replaces the list of health aggregation\npolicies when the list is empty.", "properties": { "code": { "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", @@ -55652,30 +55926,9 @@ false }, "type": "object" }, -"HealthCheckLogConfig": { -"description": "Configuration of logging on a health check. If logging is enabled, logs\nwill be exported to Stackdriver.", -"id": "HealthCheckLogConfig", -"properties": { -"enable": { -"description": "Indicates whether or not to export logs. This is false by default, which\nmeans no health check logging will be done.", -"type": "boolean" -} -}, -"type": "object" -}, -"HealthCheckReference": { -"description": "A full or valid partial URL to a health check. For example, the following are\nvalid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check\n - projects/project-id/global/httpHealthChecks/health-check\n - global/httpHealthChecks/health-check", -"id": "HealthCheckReference", -"properties": { -"healthCheck": { -"type": "string" -} -}, -"type": "object" -}, -"HealthCheckService": { -"description": "Represents a Health-Check as a Service resource.", -"id": "HealthCheckService", +"HealthAggregationPolicy": { +"description": "Represents a health aggregation policy.\n\nA health aggregation policy resource defines a policy to aggregate health.\n\nFor more information, see\nHealth checks overview.", +"id": "HealthAggregationPolicy", "properties": { "creationTimestamp": { "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", @@ -55687,28 +55940,14 @@ false "type": "string" }, "fingerprint": { -"description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthCheckService. An up-to-date fingerprint must\nbe provided in order to patch/update the HealthCheckService; Otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nHealthCheckService.", +"description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthAggregationPolicy. An up-to-date fingerprint\nmust be provided in order to patch the HealthAggregationPolicy; Otherwise,\nthe request will fail with error 412 conditionNotMet. To see\nthe latest fingerprint, make a get() request to retrieve the\nHealthAggregationPolicy.", "format": "byte", "type": "string" }, -"healthChecks": { -"description": "A list of URLs to the HealthCheck resources. Must have\nat least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For\nregional HealthCheckService, theHealthCheck must be regional and in the same\nregion. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the\nglobal HealthChecks must specify sourceRegions,\nand HealthChecks that specify sourceRegions can\nonly be used with global INTERNET_IP_PORTNetworkEndpointGroups.", -"items": { -"type": "string" -}, -"type": "array" -}, -"healthStatusAggregationPolicy": { -"description": "Optional. Policy for how the results from multiple health checks\nfor the same endpoint are aggregated. Defaults to NO_AGGREGATION\nif unspecified.\n \n - NO_AGGREGATION. An EndpointHealth message is\n returned for each pair in the health check\n service.\n - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY.\n\n.\nThis is only allowed with regional HealthCheckService.", -"enum": [ -"AND", -"NO_AGGREGATION" -], -"enumDescriptions": [ -"If any backend's health check reports UNHEALTHY,\nthen UNHEALTHY is the HealthState of\nthe entire health check service. If all backend's are healthy,\nthe HealthState of the health check service isHEALTHY.", -"An EndpointHealth message is returned for each\nbackend in the health check service." -], -"type": "string" +"healthyPercentThreshold": { +"description": "Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a\npercentage) of healthy endpoints required in order to consider the\naggregated health result HEALTHY. Defaults to 60. Must be in\nrange [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,\nand will be set to the default if unspecified. Note that both this\nthreshold and minHealthyThreshold must be satisfied in order\nfor HEALTHY to be the aggregated result. \"Endpoints\" refers to network\nendpoints within a Network Endpoint Group or instances within an Instance\nGroup.", +"format": "uint32", +"type": "integer" }, "id": { "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", @@ -55717,32 +55956,35 @@ false "type": "string" }, "kind": { -"default": "compute#healthCheckService", -"description": "Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.", +"default": "compute#healthAggregationPolicy", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation\npolicies.", "readOnly": true, "type": "string" }, +"minHealthyThreshold": { +"description": "Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of\nhealthy endpoints required in order to consider the aggregated health\nresult HEALTHY. Defaults to 1. Must be positive. Not\napplicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,\nand will be set to the default if unspecified. Note that both this\nthreshold and healthyPercentThreshold must be satisfied in\norder for HEALTHY to be the aggregated result. \"Endpoints\" refers to\nnetwork endpoints within a Network Endpoint Group or instances within an\nInstance Group.", +"format": "uint32", +"type": "integer" +}, "name": { -"description": "Name of the resource. The name must be 1-63 characters long, and comply\nwith RFC1035. Specifically, the name must be 1-63 characters\nlong and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character\nmust be a lowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", +"description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, -"networkEndpointGroups": { -"description": "A list of URLs to the NetworkEndpointGroup\nresources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in\nzones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups\nmust be global INTERNET_IP_PORT.", -"items": { -"type": "string" -}, -"type": "array" -}, -"notificationEndpoints": { -"description": "A list of URLs to the NotificationEndpoint\nresources. Must not have more than 10. A list of endpoints for\nreceiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the\nsame region. For global HealthCheckService,NotificationEndpoint must be global.", -"items": { +"policyType": { +"description": "Specifies the type of the healthAggregationPolicy. The only allowed value\nfor global resources is DNS_PUBLIC_IP_POLICY. The only allowed\nvalue for regional resources is BACKEND_SERVICE_POLICY. Must\nbe specified when the healthAggregationPolicy is created, and cannot be\nmutated.", +"enum": [ +"BACKEND_SERVICE_POLICY", +"DNS_PUBLIC_IP_POLICY" +], +"enumDescriptions": [ +"", +"" +], "type": "string" }, -"type": "array" -}, "region": { -"description": "Output only. [Output Only] URL of the region where the health check service\nresides. This field is not applicable to global health check services.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", +"description": "Output only. [Output Only] URL of the region where the health aggregation policy\nresides. This field applies only to the regional resource. You must specify\nthis field as part of the HTTP request URL. It is not settable as a field\nin the request body.", "readOnly": true, "type": "string" }, @@ -55750,45 +55992,39 @@ false "description": "Output only. [Output Only] Server-defined URL for the resource.", "readOnly": true, "type": "string" -} -}, -"type": "object" }, -"HealthCheckServiceReference": { -"description": "A full or valid partial URL to a health check service. For example, the\nfollowing are valid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - regions/us-west1/healthCheckServices/health-check-service", -"id": "HealthCheckServiceReference", -"properties": { -"healthCheckService": { +"selfLinkWithId": { +"description": "Output only. [Output Only] Server-defined URL with id for the resource.", +"readOnly": true, "type": "string" } }, "type": "object" }, -"HealthCheckServicesList": { -"id": "HealthCheckServicesList", +"HealthAggregationPolicyAggregatedList": { +"description": "Contains a list of HealthAggregationPoliciesScopedList.", +"id": "HealthAggregationPolicyAggregatedList", "properties": { "id": { -"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", -"readOnly": true, +"description": "[Output Only] Unique identifier for the resource; defined by the server.", "type": "string" }, "items": { -"description": "Output only. A list of HealthCheckService resources.", -"items": { -"$ref": "HealthCheckService" +"additionalProperties": { +"$ref": "HealthAggregationPoliciesScopedList", +"description": "Name of the scope containing this set of HealthAggregationPolicies." }, -"readOnly": true, -"type": "array" +"description": "A list of HealthAggregationPoliciesScopedList resources.", +"type": "object" }, "kind": { -"default": "compute#healthCheckServicesList", -"description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of\nHealthCheckServices.", +"default": "compute#healthAggregationPolicyAggregatedList", +"description": "Output only. Type of resource.", "readOnly": true, "type": "string" }, "nextPageToken": { -"description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", -"readOnly": true, +"description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", "type": "string" }, "selfLink": { @@ -55796,6 +56032,14 @@ false "readOnly": true, "type": "string" }, +"unreachables": { +"description": "Output only. [Output Only] Unreachable resources.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, "warning": { "description": "[Output Only] Informational warning message.", "properties": { @@ -55923,24 +56167,23 @@ false }, "type": "object" }, -"HealthChecksAggregatedList": { -"id": "HealthChecksAggregatedList", +"HealthAggregationPolicyList": { +"id": "HealthAggregationPolicyList", "properties": { "id": { "description": "[Output Only] Unique identifier for the resource; defined by the server.", "type": "string" }, "items": { -"additionalProperties": { -"$ref": "HealthChecksScopedList", -"description": "Name of the scope containing this set of HealthChecks." +"description": "A list of HealthAggregationPolicy resources.", +"items": { +"$ref": "HealthAggregationPolicy" }, -"description": "A list of HealthChecksScopedList resources.", -"type": "object" +"type": "array" }, "kind": { -"default": "compute#healthChecksAggregatedList", -"description": "Output only. Type of resource.", +"default": "compute#healthAggregationPolicyList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation\npolicies.", "readOnly": true, "type": "string" }, @@ -55949,18 +56192,9 @@ false "type": "string" }, "selfLink": { -"description": "Output only. [Output Only] Server-defined URL for this resource.", -"readOnly": true, -"type": "string" -}, -"unreachables": { -"description": "Output only. [Output Only] Unreachable resources.", -"items": { +"description": "[Output Only] Server-defined URL for this resource.", "type": "string" }, -"readOnly": true, -"type": "array" -}, "warning": { "description": "[Output Only] Informational warning message.", "properties": { @@ -56088,18 +56322,728 @@ false }, "type": "object" }, -"HealthChecksScopedList": { -"id": "HealthChecksScopedList", +"HealthCheck": { +"description": "Represents a health check resource.\n\nGoogle Compute Engine has two health check resources:\n\n* [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)\n* [Global](/compute/docs/reference/rest/v1/healthChecks)\n\nThese health check resources can be used for load balancing and for\nautohealing VMs in a managed instance group (MIG).\n\n**Load balancing**\n\nHealth check requirements vary depending on the type of load balancer. For\ndetails about the type of health check supported for\neach load balancer and corresponding backend type,\nsee Health\nchecks overview: Load balancer guide.\n\n**Autohealing in MIGs**\n\nThe health checks that you use for autohealing VMs in a MIG can be either\nregional or global. For more information, see Set up an\napplication health check and autohealing.\n\nFor more information, seeHealth checks\noverview.", +"id": "HealthCheck", "properties": { -"healthChecks": { -"description": "A list of HealthChecks contained in this scope.", +"checkIntervalSec": { +"description": "How often (in seconds) to send a health check. The default value is 5\nseconds.", +"format": "int32", +"type": "integer" +}, +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp in3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"grpcHealthCheck": { +"$ref": "GRPCHealthCheck" +}, +"grpcTlsHealthCheck": { +"$ref": "GRPCTLSHealthCheck" +}, +"healthyThreshold": { +"description": "A so-far unhealthy instance will be marked healthy after this\nmany consecutive successes. The default value is 2.", +"format": "int32", +"type": "integer" +}, +"http2HealthCheck": { +"$ref": "HTTP2HealthCheck" +}, +"httpHealthCheck": { +"$ref": "HTTPHealthCheck" +}, +"httpsHealthCheck": { +"$ref": "HTTPSHealthCheck" +}, +"id": { +"description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"type": "string" +}, +"kind": { +"default": "compute#healthCheck", +"description": "Output only. Type of the resource.", +"readOnly": true, +"type": "string" +}, +"logConfig": { +"$ref": "HealthCheckLogConfig", +"description": "Configure logging on this health check." +}, +"name": { +"description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nFor example, a name that is 1-63 characters long, matches the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with\nRFC1035. This regular expression describes a name where the first\ncharacter is a lowercase letter, and all following characters are a dash,\nlowercase letter, or digit, except the last character, which isn't a dash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"region": { +"description": "Output only. [Output Only] Region where the health check resides. Not applicable to\nglobal health checks.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "[Output Only] Server-defined URL for the resource.", +"type": "string" +}, +"sourceRegions": { +"description": "The list of cloud regions from which health checks are performed. If any\nregions are specified, then exactly 3 regions should be specified. The\nregion names must be valid names of Google Cloud regions.\nThis can only be set for global health check.\nIf this list is non-empty, then there are restrictions\non what other health check fields are supported and what other resources\ncan use this health check:\n \n - SSL, HTTP2, and GRPC protocols are not supported.\n - The TCP request field is not supported.\n - The proxyHeader field for HTTP, HTTPS, and TCP is not\n supported.\n - The checkIntervalSec field must be at least 30.\n - The health check cannot be used with BackendService nor with managed\n instance group auto-healing.", +"items": { +"type": "string" +}, +"type": "array" +}, +"sslHealthCheck": { +"$ref": "SSLHealthCheck" +}, +"tcpHealthCheck": { +"$ref": "TCPHealthCheck" +}, +"timeoutSec": { +"description": "How long (in seconds) to wait before claiming failure. The default value is\n5 seconds. It is invalid for timeoutSec to have greater\nvalue than checkIntervalSec.", +"format": "int32", +"type": "integer" +}, +"type": { +"description": "Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the\nprotocol-specific health check fields must be specified, which must matchtype field.", +"enum": [ +"GRPC", +"GRPC_WITH_TLS", +"HTTP", +"HTTP2", +"HTTPS", +"INVALID", +"SSL", +"TCP" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"", +"", +"" +], +"type": "string" +}, +"unhealthyThreshold": { +"description": "A so-far healthy instance will be marked unhealthy after this many\nconsecutive failures. The default value is 2.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"HealthCheckList": { +"description": "Contains a list of HealthCheck resources.", +"id": "HealthCheckList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"description": "A list of HealthCheck resources.", "items": { "$ref": "HealthCheck" }, "type": "array" }, +"kind": { +"default": "compute#healthCheckList", +"description": "Output only. Type of resource.", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, "warning": { -"description": "Informational warning which replaces the list of\nbackend services when the list is empty.", +"description": "[Output Only] Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed\noperation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as\ndeprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as\nexperimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden.\nDeprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the\nnetwork.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite\nthe mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g:\nregions.list).", +"The user attempted to use a resource that requires a TOS they have not\naccepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, +"HealthCheckLogConfig": { +"description": "Configuration of logging on a health check. If logging is enabled, logs\nwill be exported to Stackdriver.", +"id": "HealthCheckLogConfig", +"properties": { +"enable": { +"description": "Indicates whether or not to export logs. This is false by default, which\nmeans no health check logging will be done.", +"type": "boolean" +} +}, +"type": "object" +}, +"HealthCheckReference": { +"description": "A full or valid partial URL to a health check. For example, the following are\nvalid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check\n - projects/project-id/global/httpHealthChecks/health-check\n - global/httpHealthChecks/health-check", +"id": "HealthCheckReference", +"properties": { +"healthCheck": { +"type": "string" +} +}, +"type": "object" +}, +"HealthCheckService": { +"description": "Represents a Health-Check as a Service resource.", +"id": "HealthCheckService", +"properties": { +"creationTimestamp": { +"description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "An optional description of this resource. Provide this property when you\ncreate the resource.", +"type": "string" +}, +"fingerprint": { +"description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthCheckService. An up-to-date fingerprint must\nbe provided in order to patch/update the HealthCheckService; Otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nHealthCheckService.", +"format": "byte", +"type": "string" +}, +"healthChecks": { +"description": "A list of URLs to the HealthCheck resources. Must have\nat least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For\nregional HealthCheckService, theHealthCheck must be regional and in the same\nregion. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the\nglobal HealthChecks must specify sourceRegions,\nand HealthChecks that specify sourceRegions can\nonly be used with global INTERNET_IP_PORTNetworkEndpointGroups.", +"items": { +"type": "string" +}, +"type": "array" +}, +"healthStatusAggregationPolicy": { +"description": "Optional. Policy for how the results from multiple health checks\nfor the same endpoint are aggregated. Defaults to NO_AGGREGATION\nif unspecified.\n \n - NO_AGGREGATION. An EndpointHealth message is\n returned for each pair in the health check\n service.\n - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY.\n\n.\nThis is only allowed with regional HealthCheckService.", +"enum": [ +"AND", +"NO_AGGREGATION" +], +"enumDescriptions": [ +"If any backend's health check reports UNHEALTHY,\nthen UNHEALTHY is the HealthState of\nthe entire health check service. If all backend's are healthy,\nthe HealthState of the health check service isHEALTHY.", +"An EndpointHealth message is returned for each\nbackend in the health check service." +], +"type": "string" +}, +"id": { +"description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", +"format": "uint64", +"readOnly": true, +"type": "string" +}, +"kind": { +"default": "compute#healthCheckService", +"description": "Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Name of the resource. The name must be 1-63 characters long, and comply\nwith RFC1035. Specifically, the name must be 1-63 characters\nlong and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character\nmust be a lowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", +"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", +"type": "string" +}, +"networkEndpointGroups": { +"description": "A list of URLs to the NetworkEndpointGroup\nresources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in\nzones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups\nmust be global INTERNET_IP_PORT.", +"items": { +"type": "string" +}, +"type": "array" +}, +"notificationEndpoints": { +"description": "A list of URLs to the NotificationEndpoint\nresources. Must not have more than 10. A list of endpoints for\nreceiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the\nsame region. For global HealthCheckService,NotificationEndpoint must be global.", +"items": { +"type": "string" +}, +"type": "array" +}, +"region": { +"description": "Output only. [Output Only] URL of the region where the health check service\nresides. This field is not applicable to global health check services.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for the resource.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"HealthCheckServiceReference": { +"description": "A full or valid partial URL to a health check service. For example, the\nfollowing are valid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - regions/us-west1/healthCheckServices/health-check-service", +"id": "HealthCheckServiceReference", +"properties": { +"healthCheckService": { +"type": "string" +} +}, +"type": "object" +}, +"HealthCheckServicesList": { +"id": "HealthCheckServicesList", +"properties": { +"id": { +"description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", +"readOnly": true, +"type": "string" +}, +"items": { +"description": "Output only. A list of HealthCheckService resources.", +"items": { +"$ref": "HealthCheckService" +}, +"readOnly": true, +"type": "array" +}, +"kind": { +"default": "compute#healthCheckServicesList", +"description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of\nHealthCheckServices.", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", +"readOnly": true, +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"warning": { +"description": "[Output Only] Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed\noperation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as\ndeprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as\nexperimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden.\nDeprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the\nnetwork.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite\nthe mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g:\nregions.list).", +"The user attempted to use a resource that requires a TOS they have not\naccepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, +"HealthChecksAggregatedList": { +"id": "HealthChecksAggregatedList", +"properties": { +"id": { +"description": "[Output Only] Unique identifier for the resource; defined by the server.", +"type": "string" +}, +"items": { +"additionalProperties": { +"$ref": "HealthChecksScopedList", +"description": "Name of the scope containing this set of HealthChecks." +}, +"description": "A list of HealthChecksScopedList resources.", +"type": "object" +}, +"kind": { +"default": "compute#healthChecksAggregatedList", +"description": "Output only. Type of resource.", +"readOnly": true, +"type": "string" +}, +"nextPageToken": { +"description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", +"type": "string" +}, +"selfLink": { +"description": "Output only. [Output Only] Server-defined URL for this resource.", +"readOnly": true, +"type": "string" +}, +"unreachables": { +"description": "Output only. [Output Only] Unreachable resources.", +"items": { +"type": "string" +}, +"readOnly": true, +"type": "array" +}, +"warning": { +"description": "[Output Only] Informational warning message.", +"properties": { +"code": { +"description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", +"enum": [ +"CLEANUP_FAILED", +"DEPRECATED_RESOURCE_USED", +"DEPRECATED_TYPE_USED", +"DISK_SIZE_LARGER_THAN_IMAGE_SIZE", +"EXPERIMENTAL_TYPE_USED", +"EXTERNAL_API_WARNING", +"FIELD_VALUE_OVERRIDEN", +"INJECTED_KERNELS_DEPRECATED", +"INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", +"LARGE_DEPLOYMENT_WARNING", +"LIST_OVERHEAD_QUOTA_EXCEED", +"MISSING_TYPE_DEPENDENCY", +"NEXT_HOP_ADDRESS_NOT_ASSIGNED", +"NEXT_HOP_CANNOT_IP_FORWARD", +"NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", +"NEXT_HOP_INSTANCE_NOT_FOUND", +"NEXT_HOP_INSTANCE_NOT_ON_NETWORK", +"NEXT_HOP_NOT_RUNNING", +"NOT_CRITICAL_ERROR", +"NO_RESULTS_ON_PAGE", +"PARTIAL_SUCCESS", +"QUOTA_INFO_UNAVAILABLE", +"REQUIRED_TOS_AGREEMENT", +"RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", +"RESOURCE_NOT_DELETED", +"SCHEMA_VALIDATION_IGNORED", +"SINGLE_INSTANCE_PROPERTY_TEMPLATE", +"UNDECLARED_PROPERTIES", +"UNREACHABLE" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Warning about failed cleanup of transient changes made by a failed\noperation.", +"A link to a deprecated resource was created.", +"When deploying and at least one of the resources has a type marked as\ndeprecated", +"The user created a boot disk that is larger than image size.", +"When deploying and at least one of the resources has a type marked as\nexperimental", +"Warning that is present in an external api call", +"Warning that value of a field has been overridden.\nDeprecated unused field.", +"The operation involved use of an injected kernel, which is deprecated.", +"A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", +"When deploying a deployment with a exceedingly large number of resources", +"Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", +"A resource depends on a missing type", +"The route's nextHopIp address is not assigned to an instance on the\nnetwork.", +"The route's next hop instance cannot ip forward.", +"The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", +"The route's nextHopInstance URL refers to an instance that does not exist.", +"The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", +"The route's next hop instance does not have a status of RUNNING.", +"Error which is not critical. We decided to continue the process despite\nthe mentioned error.", +"No results are present on a particular list page.", +"Success is reported, but some results may be missing due to errors", +"Quota information is not available to client requests (e.g:\nregions.list).", +"The user attempted to use a resource that requires a TOS they have not\naccepted.", +"Warning that a resource is in use.", +"One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", +"When a resource schema validation is ignored.", +"Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", +"When undeclared properties in the schema are present", +"A given scope cannot be reached." +], +"type": "string" +}, +"data": { +"description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", +"items": { +"properties": { +"key": { +"description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", +"type": "string" +}, +"value": { +"description": "[Output Only] A warning data value corresponding to the key.", +"type": "string" +} +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "[Output Only] A human-readable description of the warning code.", +"type": "string" +} +}, +"type": "object" +} +}, +"type": "object" +}, +"HealthChecksScopedList": { +"id": "HealthChecksScopedList", +"properties": { +"healthChecks": { +"description": "A list of HealthChecks contained in this scope.", +"items": { +"$ref": "HealthCheck" +}, +"type": "array" +}, +"warning": { +"description": "Informational warning which replaces the list of\nbackend services when the list is empty.", "properties": { "code": { "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", @@ -57635,7 +58579,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -61236,7 +62180,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -61346,7 +62290,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" }, "resourcePolicies": { @@ -67378,7 +68322,7 @@ false "additionalProperties": { "$ref": "LocationPolicyLocation" }, -"description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.", +"description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.\nThe bulkInsert operation doesn't create instances in an AI zone, even if\nan AI zone is available in the specified region. For example, if you set a\nDENY preference for us-central1-a, Compute Engine will consider\nus-central1-b and us-central1-c for instance creation, but not\nus-central1-ai1a. Also, you can't use the locations[] configuration to\nallow instance creation in an AI zone. To include an AI zone in bulkInsert\noperations, use the locationPolicy.zones[] field.", "type": "object" }, "targetShape": { @@ -67394,6 +68338,13 @@ false "GCE prioritizes acquisition of resources, scheduling VMs in zones\nwhere resources are available while distributing VMs as evenly as\npossible across allowed zones to minimize the impact of zonal failure.\nRecommended for highly available serving workloads." ], "type": "string" +}, +"zones": { +"description": "The bulkInsert operation applies any preferences set in the locations\nfield to the specific zones listed in the zones field if the same zones\nare specified in both fields.", +"items": { +"$ref": "LocationPolicyZoneConfiguration" +}, +"type": "array" } }, "type": "object" @@ -67434,6 +68385,16 @@ false }, "type": "object" }, +"LocationPolicyZoneConfiguration": { +"id": "LocationPolicyZoneConfiguration", +"properties": { +"zone": { +"description": "The URL of the zone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid partial URLs,\nsuch as zones/us-central1-a.", +"type": "string" +} +}, +"type": "object" +}, "MachineImage": { "description": "Represents a machine image resource.\n\nA machine image is a Compute Engine resource that stores all the\nconfiguration, metadata, permissions, and data from one or more disks\nrequired to create a Virtual machine (VM) instance. For more information, seeMachine images.", "id": "MachineImage", @@ -80457,6 +81418,10 @@ false "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, +"params": { +"$ref": "ReservationParams", +"description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." +}, "protectionTier": { "description": "Protection tier for the workload which specifies the workload expectations\nin the event of infrastructure failures at data center (e.g. power\nand/or cooling failures).", "enum": [ @@ -81286,6 +82251,20 @@ false }, "type": "object" }, +"ReservationParams": { +"description": "Additional reservation params.", +"id": "ReservationParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Input only. Resource manager tags to be bound to the reservation. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"type": "object" +} +}, +"type": "object" +}, "ReservationSlot": { "description": "Represents a reservation slot resource.", "id": "ReservationSlot", @@ -81338,13 +82317,15 @@ false "ACTIVE", "CREATING", "DELETING", -"STATE_UNSPECIFIED" +"STATE_UNSPECIFIED", +"UNAVAILABLE" ], "enumDescriptions": [ "The reservation slot has allocated all its resources.", "The resources are being allocated for the reservation slot.", "The reservation slot is currently being deleted.", -"" +"", +"The reservation slot is currently unavailable." ], "readOnly": true, "type": "string" @@ -83153,6 +84134,10 @@ false "description": "Effective enable-oslogin value at Instance level.", "type": "boolean" }, +"gceContainerDeclarationMetadataValue": { +"description": "Effective gce-container-declaration value at Instance level.", +"type": "boolean" +}, "serialPortEnableMetadataValue": { "description": "Effective serial-port-enable value at Instance level.", "type": "boolean" @@ -88791,7 +89776,7 @@ false "additionalProperties": { "type": "string" }, -"description": "Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", +"description": "Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", "type": "object" } }, @@ -96302,6 +97287,10 @@ false "description": "URL of the network to which this VPN gateway is attached. Provided by the\nclient when the VPN gateway is created.", "type": "string" }, +"params": { +"$ref": "TargetVpnGatewayParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, "region": { "description": "[Output Only] URL of the region where the target VPN gateway resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", "type": "string" @@ -96658,6 +97647,19 @@ false }, "type": "object" }, +"TargetVpnGatewayParams": { +"id": "TargetVpnGatewayParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "TargetVpnGatewaysScopedList": { "id": "TargetVpnGatewaysScopedList", "properties": { @@ -98311,6 +99313,10 @@ false "description": "URL of the network to which this VPN gateway is attached. Provided by the\nclient when the VPN gateway is created.", "type": "string" }, +"params": { +"$ref": "VpnGatewayParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, "region": { "description": "Output only. [Output Only] URL of the region where the VPN gateway resides.", "readOnly": true, @@ -98667,6 +99673,19 @@ false }, "type": "object" }, +"VpnGatewayParams": { +"id": "VpnGatewayParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "VpnGatewayStatus": { "id": "VpnGatewayStatus", "properties": { @@ -99001,6 +100020,10 @@ false "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, +"params": { +"$ref": "VpnTunnelParams", +"description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." +}, "peerExternalGateway": { "description": "URL of the peer side external VPN gateway to which this VPN tunnel is\nconnected.\nProvided by the client when the VPN tunnel is created.\nThis field is exclusive with the field peerGcpGateway.", "type": "string" @@ -99429,6 +100452,19 @@ false }, "type": "object" }, +"VpnTunnelParams": { +"id": "VpnTunnelParams", +"properties": { +"resourceManagerTags": { +"additionalProperties": { +"type": "string" +}, +"description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", +"type": "object" +} +}, +"type": "object" +}, "VpnTunnelPhase1Algorithms": { "id": "VpnTunnelPhase1Algorithms", "properties": { From 5561147a9b6fb406b8fadd604b4c8628a181c694 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:56 +0000 Subject: [PATCH 06/29] feat(containeranalysis): update the api #### containeranalysis:v1 The following keys were added: - schemas.BaseImage.properties.registry.type (Total Keys: 1) #### containeranalysis:v1alpha1 The following keys were added: - schemas.BaseImage.properties.registry.type (Total Keys: 1) --- ....projects.locations.notes.occurrences.html | 2 ++ ...sis_v1.projects.locations.occurrences.html | 16 ++++++++++++++++ ...nalysis_v1.projects.notes.occurrences.html | 2 ++ ...aineranalysis_v1.projects.occurrences.html | 16 ++++++++++++++++ ...aineranalysis_v1alpha1.projects.notes.html | 6 ++++++ ...s_v1alpha1.projects.notes.occurrences.html | 3 +++ ...nalysis_v1alpha1.projects.occurrences.html | 19 +++++++++++++++++++ ...ineranalysis_v1alpha1.providers.notes.html | 6 ++++++ ..._v1alpha1.providers.notes.occurrences.html | 3 +++ .../documents/containeranalysis.v1.json | 6 +++++- .../documents/containeranalysis.v1alpha1.json | 6 +++++- 11 files changed, 83 insertions(+), 2 deletions(-) diff --git a/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html b/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html index a1ab20e9d2c..37270b074fc 100644 --- a/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.locations.notes.occurrences.html @@ -796,6 +796,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -910,6 +911,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1.projects.locations.occurrences.html b/docs/dyn/containeranalysis_v1.projects.locations.occurrences.html index 8b2c5082473..bfdbea0a264 100644 --- a/docs/dyn/containeranalysis_v1.projects.locations.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.locations.occurrences.html @@ -812,6 +812,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -926,6 +927,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1699,6 +1701,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1813,6 +1816,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2591,6 +2595,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2705,6 +2710,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -3474,6 +3480,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -3588,6 +3595,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -4382,6 +4390,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -4496,6 +4505,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -5659,6 +5669,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -5773,6 +5784,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -6563,6 +6575,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -6677,6 +6690,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -7447,6 +7461,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -7561,6 +7576,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html b/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html index c2ffedee097..f092b187755 100644 --- a/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.notes.occurrences.html @@ -796,6 +796,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -910,6 +911,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1.projects.occurrences.html b/docs/dyn/containeranalysis_v1.projects.occurrences.html index 07df20237fd..5dcd5e3673f 100644 --- a/docs/dyn/containeranalysis_v1.projects.occurrences.html +++ b/docs/dyn/containeranalysis_v1.projects.occurrences.html @@ -812,6 +812,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -926,6 +927,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1699,6 +1701,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1813,6 +1816,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2591,6 +2595,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2705,6 +2710,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -3474,6 +3480,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -3588,6 +3595,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -4382,6 +4390,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -4496,6 +4505,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -5659,6 +5669,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -5773,6 +5784,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -6563,6 +6575,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -6677,6 +6690,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -7447,6 +7461,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -7561,6 +7576,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry in which the base image is from. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1alpha1.projects.notes.html b/docs/dyn/containeranalysis_v1alpha1.projects.notes.html index 785641febfa..0ff12c6c699 100644 --- a/docs/dyn/containeranalysis_v1alpha1.projects.notes.html +++ b/docs/dyn/containeranalysis_v1alpha1.projects.notes.html @@ -390,6 +390,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -711,6 +712,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1055,6 +1057,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1431,6 +1434,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1768,6 +1772,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2088,6 +2093,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html b/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html index 8398d953bfa..0a3eb5c4b43 100644 --- a/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html @@ -851,6 +851,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -974,6 +975,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1004,6 +1006,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1alpha1.projects.occurrences.html b/docs/dyn/containeranalysis_v1alpha1.projects.occurrences.html index ad0b2f1b6e9..0b594f7d613 100644 --- a/docs/dyn/containeranalysis_v1alpha1.projects.occurrences.html +++ b/docs/dyn/containeranalysis_v1alpha1.projects.occurrences.html @@ -867,6 +867,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -990,6 +991,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1020,6 +1022,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1837,6 +1840,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1960,6 +1964,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1990,6 +1995,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2831,6 +2837,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2954,6 +2961,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2984,6 +2992,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -3374,6 +3383,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -4228,6 +4238,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -4351,6 +4362,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -4381,6 +4393,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -5215,6 +5228,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -5338,6 +5352,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -5368,6 +5383,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -6185,6 +6201,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -6308,6 +6325,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -6338,6 +6356,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1alpha1.providers.notes.html b/docs/dyn/containeranalysis_v1alpha1.providers.notes.html index 4e8c2037715..4ae9d778029 100644 --- a/docs/dyn/containeranalysis_v1alpha1.providers.notes.html +++ b/docs/dyn/containeranalysis_v1alpha1.providers.notes.html @@ -390,6 +390,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -711,6 +712,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1055,6 +1057,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1431,6 +1434,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1768,6 +1772,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -2088,6 +2093,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html b/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html index 9496b4605fa..2c6453d81bf 100644 --- a/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html +++ b/docs/dyn/containeranalysis_v1alpha1.providers.notes.occurrences.html @@ -851,6 +851,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -974,6 +975,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], @@ -1004,6 +1006,7 @@

Method Details

{ # BaseImage describes a base image of a container image. "layerCount": 42, # The number of layers that the base image is composed of. "name": "A String", # The name of the base image. + "registry": "A String", # The registry of the base image. "repository": "A String", # The repository name in which the base image is from. }, ], diff --git a/googleapiclient/discovery_cache/documents/containeranalysis.v1.json b/googleapiclient/discovery_cache/documents/containeranalysis.v1.json index 92596c1cdd8..aa3ebc22f4d 100644 --- a/googleapiclient/discovery_cache/documents/containeranalysis.v1.json +++ b/googleapiclient/discovery_cache/documents/containeranalysis.v1.json @@ -1715,7 +1715,7 @@ } } }, -"revision": "20260130", +"revision": "20260213", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -1897,6 +1897,10 @@ "description": "The name of the base image.", "type": "string" }, +"registry": { +"description": "The registry in which the base image is from.", +"type": "string" +}, "repository": { "description": "The repository name in which the base image is from.", "type": "string" diff --git a/googleapiclient/discovery_cache/documents/containeranalysis.v1alpha1.json b/googleapiclient/discovery_cache/documents/containeranalysis.v1alpha1.json index 6565ea23a2f..bb259fefe03 100644 --- a/googleapiclient/discovery_cache/documents/containeranalysis.v1alpha1.json +++ b/googleapiclient/discovery_cache/documents/containeranalysis.v1alpha1.json @@ -1452,7 +1452,7 @@ } } }, -"revision": "20260123", +"revision": "20260213", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -1606,6 +1606,10 @@ "description": "The name of the base image.", "type": "string" }, +"registry": { +"description": "The registry of the base image.", +"type": "string" +}, "repository": { "description": "The repository name in which the base image is from.", "type": "string" From 0b06fceeb8a89c11b6c688b3978c6235c019e6de Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:56 +0000 Subject: [PATCH 07/29] feat(dataflow): update the api #### dataflow:v1b3 The following keys were added: - schemas.WorkerPool.properties.diskProvisionedIops (Total Keys: 2) - schemas.WorkerPool.properties.diskProvisionedThroughputMibps (Total Keys: 2) The following keys were changed: - endpoints (Total Keys: 1) --- docs/dyn/dataflow_v1b3.projects.jobs.html | 14 ++++++++++++++ ...w_v1b3.projects.locations.flexTemplates.html | 2 ++ .../dataflow_v1b3.projects.locations.jobs.html | 12 ++++++++++++ ...aflow_v1b3.projects.locations.templates.html | 4 ++++ docs/dyn/dataflow_v1b3.projects.templates.html | 4 ++++ .../documents/dataflow.v1b3.json | 17 ++++++++++++++++- 6 files changed, 52 insertions(+), 1 deletion(-) diff --git a/docs/dyn/dataflow_v1b3.projects.jobs.html b/docs/dyn/dataflow_v1b3.projects.jobs.html index 53c9a795a62..a821a883fc8 100644 --- a/docs/dyn/dataflow_v1b3.projects.jobs.html +++ b/docs/dyn/dataflow_v1b3.projects.jobs.html @@ -214,6 +214,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -579,6 +581,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -928,6 +932,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -1284,6 +1290,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -1700,6 +1708,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -2106,6 +2116,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -2449,6 +2461,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. diff --git a/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html b/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html index 9aaa6278624..3ae321c66cf 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html @@ -296,6 +296,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. diff --git a/docs/dyn/dataflow_v1b3.projects.locations.jobs.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html index 0a28f0f2074..015e43de624 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.jobs.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html @@ -202,6 +202,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -550,6 +552,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -906,6 +910,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -1432,6 +1438,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -1840,6 +1848,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -2182,6 +2192,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. diff --git a/docs/dyn/dataflow_v1b3.projects.locations.templates.html b/docs/dyn/dataflow_v1b3.projects.locations.templates.html index 78160f9b1e3..ff21ad63f05 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.templates.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.templates.html @@ -203,6 +203,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -704,6 +706,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. diff --git a/docs/dyn/dataflow_v1b3.projects.templates.html b/docs/dyn/dataflow_v1b3.projects.templates.html index 0d077f9482a..e921a1cfeea 100644 --- a/docs/dyn/dataflow_v1b3.projects.templates.html +++ b/docs/dyn/dataflow_v1b3.projects.templates.html @@ -202,6 +202,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. @@ -703,6 +705,8 @@

Method Details

}, ], "defaultPackageSet": "A String", # The default package set to install. This allows the service to select a default set of packages which are useful to worker harnesses written in a particular language. + "diskProvisionedIops": "A String", # Optional. IOPS provisioned for the root disk for VMs. + "diskProvisionedThroughputMibps": "A String", # Optional. Throughput provisioned for the root disk for VMs. "diskSizeGb": 42, # Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default. "diskSourceImage": "A String", # Fully qualified source image for disks. "diskType": "A String", # Type of root disk for VMs. If empty or unspecified, the service will attempt to choose a reasonable default. diff --git a/googleapiclient/discovery_cache/documents/dataflow.v1b3.json b/googleapiclient/discovery_cache/documents/dataflow.v1b3.json index ebcd40edb46..cc7ef452e1a 100644 --- a/googleapiclient/discovery_cache/documents/dataflow.v1b3.json +++ b/googleapiclient/discovery_cache/documents/dataflow.v1b3.json @@ -96,6 +96,11 @@ }, { "description": "Regional Endpoint", +"endpointUrl": "https://dataflow.europe-north2.rep.googleapis.com/", +"location": "europe-north2" +}, +{ +"description": "Regional Endpoint", "endpointUrl": "https://dataflow.europe-southwest1.rep.googleapis.com/", "location": "europe-southwest1" }, @@ -2395,7 +2400,7 @@ } } }, -"revision": "20260208", +"revision": "20260213", "rootUrl": "https://dataflow.googleapis.com/", "schemas": { "ApproximateProgress": { @@ -8189,6 +8194,16 @@ false ], "type": "string" }, +"diskProvisionedIops": { +"description": "Optional. IOPS provisioned for the root disk for VMs.", +"format": "int64", +"type": "string" +}, +"diskProvisionedThroughputMibps": { +"description": "Optional. Throughput provisioned for the root disk for VMs.", +"format": "int64", +"type": "string" +}, "diskSizeGb": { "description": "Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.", "format": "int32", From 457385fe619a3ff6ec6c819a54fa31d1357b6e11 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:56 +0000 Subject: [PATCH 08/29] feat(datamanager): update the api #### datamanager:v1 The following keys were added: - resources.accountTypes.resources.accounts.resources.insights.methods.retrieve (Total Keys: 12) - resources.accountTypes.resources.accounts.resources.partnerLinks.methods.create (Total Keys: 12) - resources.accountTypes.resources.accounts.resources.partnerLinks.methods.delete (Total Keys: 11) - resources.accountTypes.resources.accounts.resources.partnerLinks.methods.search (Total Keys: 18) - resources.accountTypes.resources.accounts.resources.userListDirectLicenses.methods.create (Total Keys: 12) - resources.accountTypes.resources.accounts.resources.userListDirectLicenses.methods.get (Total Keys: 11) - resources.accountTypes.resources.accounts.resources.userListDirectLicenses.methods.list (Total Keys: 18) - resources.accountTypes.resources.accounts.resources.userListDirectLicenses.methods.patch (Total Keys: 15) - resources.accountTypes.resources.accounts.resources.userListGlobalLicenses.methods.create (Total Keys: 12) - resources.accountTypes.resources.accounts.resources.userListGlobalLicenses.methods.get (Total Keys: 11) - resources.accountTypes.resources.accounts.resources.userListGlobalLicenses.methods.list (Total Keys: 18) - resources.accountTypes.resources.accounts.resources.userListGlobalLicenses.methods.patch (Total Keys: 15) - resources.accountTypes.resources.accounts.resources.userListGlobalLicenses.resources.userListGlobalLicenseCustomerInfos.methods.list (Total Keys: 18) - resources.accountTypes.resources.accounts.resources.userLists.methods.create (Total Keys: 14) - resources.accountTypes.resources.accounts.resources.userLists.methods.delete (Total Keys: 13) - resources.accountTypes.resources.accounts.resources.userLists.methods.get (Total Keys: 11) - resources.accountTypes.resources.accounts.resources.userLists.methods.list (Total Keys: 18) - resources.accountTypes.resources.accounts.resources.userLists.methods.patch (Total Keys: 17) - schemas.AudienceMember.properties.ppidData.$ref (Total Keys: 1) - schemas.AudienceMember.properties.userIdData.$ref (Total Keys: 1) - schemas.Baseline (Total Keys: 4) - schemas.ContactIdInfo (Total Keys: 6) - schemas.Empty (Total Keys: 2) - schemas.IngestAudienceMembersStatus.properties.ppidDataIngestionStatus.$ref (Total Keys: 1) - schemas.IngestAudienceMembersStatus.properties.userIdDataIngestionStatus.$ref (Total Keys: 1) - schemas.IngestPpidDataStatus (Total Keys: 6) - schemas.IngestUserIdDataStatus (Total Keys: 6) - schemas.IngestedUserListInfo (Total Keys: 10) - schemas.ListUserListDirectLicensesResponse (Total Keys: 5) - schemas.ListUserListGlobalLicenseCustomerInfosResponse (Total Keys: 5) - schemas.ListUserListGlobalLicensesResponse (Total Keys: 5) - schemas.ListUserListsResponse (Total Keys: 5) - schemas.Location (Total Keys: 4) - schemas.MarketingDataInsight (Total Keys: 13) - schemas.MobileIdInfo (Total Keys: 5) - schemas.PairIdInfo (Total Keys: 12) - schemas.PartnerAudienceInfo (Total Keys: 4) - schemas.PartnerLink (Total Keys: 7) - schemas.PpidData (Total Keys: 4) - schemas.PseudonymousIdInfo (Total Keys: 6) - schemas.RemoveAudienceMembersStatus.properties.ppidDataRemovalStatus.$ref (Total Keys: 1) - schemas.RemoveAudienceMembersStatus.properties.userIdDataRemovalStatus.$ref (Total Keys: 1) - schemas.RemovePpidDataStatus (Total Keys: 6) - schemas.RemoveUserIdDataStatus (Total Keys: 6) - schemas.RetrieveInsightsRequest (Total Keys: 4) - schemas.RetrieveInsightsResponse (Total Keys: 4) - schemas.SearchPartnerLinksResponse (Total Keys: 5) - schemas.SizeInfo (Total Keys: 8) - schemas.TargetNetworkInfo (Total Keys: 5) - schemas.UserIdData (Total Keys: 3) - schemas.UserIdInfo (Total Keys: 3) - schemas.UserList (Total Keys: 119) --- .../datamanager_v1.accountTypes.accounts.html | 111 + ...ger_v1.accountTypes.accounts.insights.html | 135 + ...v1.accountTypes.accounts.partnerLinks.html | 216 ++ ...Types.accounts.userListDirectLicenses.html | 436 +++ ...Types.accounts.userListGlobalLicenses.html | 429 +++ ...es.userListGlobalLicenseCustomerInfos.html | 171 + ...er_v1.accountTypes.accounts.userLists.html | 538 +++ docs/dyn/datamanager_v1.accountTypes.html | 91 + docs/dyn/datamanager_v1.audienceMembers.html | 20 +- docs/dyn/datamanager_v1.html | 5 + docs/dyn/datamanager_v1.requestStatus.html | 16 + .../documents/datamanager.v1.json | 3294 +++++++++++++---- 12 files changed, 4694 insertions(+), 768 deletions(-) create mode 100644 docs/dyn/datamanager_v1.accountTypes.accounts.html create mode 100644 docs/dyn/datamanager_v1.accountTypes.accounts.insights.html create mode 100644 docs/dyn/datamanager_v1.accountTypes.accounts.partnerLinks.html create mode 100644 docs/dyn/datamanager_v1.accountTypes.accounts.userListDirectLicenses.html create mode 100644 docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html create mode 100644 docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html create mode 100644 docs/dyn/datamanager_v1.accountTypes.accounts.userLists.html create mode 100644 docs/dyn/datamanager_v1.accountTypes.html diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.html b/docs/dyn/datamanager_v1.accountTypes.accounts.html new file mode 100644 index 00000000000..7064b848b98 --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.html @@ -0,0 +1,111 @@ + + + +

Data Manager API . accountTypes . accounts

+

Instance Methods

+

+ insights() +

+

Returns the insights Resource.

+ +

+ partnerLinks() +

+

Returns the partnerLinks Resource.

+ +

+ userListDirectLicenses() +

+

Returns the userListDirectLicenses Resource.

+ +

+ userListGlobalLicenses() +

+

Returns the userListGlobalLicenses Resource.

+ +

+ userLists() +

+

Returns the userLists Resource.

+ +

+ close()

+

Close httplib2 connections.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.insights.html b/docs/dyn/datamanager_v1.accountTypes.accounts.insights.html new file mode 100644 index 00000000000..0009595ceff --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.insights.html @@ -0,0 +1,135 @@ + + + +

Data Manager API . accountTypes . accounts . insights

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ retrieve(parent, body=None, x__xgafv=None)

+

Retrieves marketing data insights for a given user list. This feature is only available to data partners. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ retrieve(parent, body=None, x__xgafv=None) +
Retrieves marketing data insights for a given user list. This feature is only available to data partners. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  parent: string, Required. The parent account that owns the user list. Format: `accountTypes/{account_type}/accounts/{account}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for DM API MarketingDataInsightsService.RetrieveInsights
+  "baseline": { # Baseline criteria against which insights are compared. # Required. Baseline for the insights requested.
+    "baselineLocation": { # The baseline location of the request. Baseline location is on OR-list of ISO 3166-1 alpha-2 region codes of the requested regions. # The baseline location of the request. Baseline location is an OR-list of the requested regions.
+      "regionCodes": [ # List of ISO 3166-1 alpha-2 region codes.
+        "A String",
+      ],
+    },
+    "locationAutoDetectionEnabled": True or False, # If set to true, the service will try to automatically detect the baseline location for insights.
+  },
+  "userListId": "A String", # Required. The user list ID for which insights are requested.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for DM API MarketingDataInsightsService.RetrieveInsights
+  "marketingDataInsights": [ # Contains the insights for the marketing data.
+    { # Insights for marketing data. This feature is only available to data partners.
+      "attributes": [ # Insights for values of a given dimension.
+        { # Insights for a collection of related attributes of the same dimension.
+          "ageRange": "A String", # Age range of the audience for which the lift is provided.
+          "gender": "A String", # Gender of the audience for which the lift is provided.
+          "lift": 3.14, # Measure of lift that the audience has for the attribute value as compared to the baseline. Range [0-1].
+          "userInterestId": "A String", # The user interest ID.
+        },
+      ],
+      "dimension": "A String", # The dimension to which the insight belongs.
+    },
+  ],
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.partnerLinks.html b/docs/dyn/datamanager_v1.accountTypes.accounts.partnerLinks.html new file mode 100644 index 00000000000..0fda4012bd4 --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.partnerLinks.html @@ -0,0 +1,216 @@ + + + +

Data Manager API . accountTypes . accounts . partnerLinks

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(parent, body=None, x__xgafv=None)

+

Creates a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

+ delete(name, x__xgafv=None)

+

Deletes a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

+ search(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Searches for all partner links to and from a given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

+ search_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ create(parent, body=None, x__xgafv=None) +
Creates a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  parent: string, Required. The parent, which owns this collection of partner links. Format: accountTypes/{account_type}/accounts/{account} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A partner link between an owning account and a partner account.
+  "name": "A String", # Identifier. The name of the partner link. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
+  "owningAccount": { # Represents a specific account. # Required. The owning account granting access to the partner account.
+    "accountId": "A String", # Required. The ID of the account. For example, your Google Ads account ID.
+    "accountType": "A String", # Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.
+    "product": "A String", # Deprecated. Use `account_type` instead.
+  },
+  "partnerAccount": { # Represents a specific account. # Required. The partner account granted access by the owning account.
+    "accountId": "A String", # Required. The ID of the account. For example, your Google Ads account ID.
+    "accountType": "A String", # Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.
+    "product": "A String", # Deprecated. Use `account_type` instead.
+  },
+  "partnerLinkId": "A String", # Output only. The partner link ID.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A partner link between an owning account and a partner account.
+  "name": "A String", # Identifier. The name of the partner link. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
+  "owningAccount": { # Represents a specific account. # Required. The owning account granting access to the partner account.
+    "accountId": "A String", # Required. The ID of the account. For example, your Google Ads account ID.
+    "accountType": "A String", # Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.
+    "product": "A String", # Deprecated. Use `account_type` instead.
+  },
+  "partnerAccount": { # Represents a specific account. # Required. The partner account granted access by the owning account.
+    "accountId": "A String", # Required. The ID of the account. For example, your Google Ads account ID.
+    "accountType": "A String", # Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.
+    "product": "A String", # Deprecated. Use `account_type` instead.
+  },
+  "partnerLinkId": "A String", # Output only. The partner link ID.
+}
+
+ +
+ delete(name, x__xgafv=None) +
Deletes a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  name: string, Required. The resource name of the partner link to delete. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
+}
+
+ +
+ search(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) +
Searches for all partner links to and from a given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  parent: string, Required. Account to search for partner links. If no `filter` is specified, all partner links where this account is either the `owning_account` or `partner_account` are returned. Format: `accountTypes/{account_type}/accounts/{account}` (required)
+  filter: string, Optional. A [filter string](//google.aip.dev/160). All fields need to be on the left hand side of each condition (for example: `partner_link_id = 123456789`). Supported operations: - `AND` - `=` - `!=` Supported fields: - `partner_link_id` - `owning_account.account_type` - `owning_account.account_id` - `partner_account.account_type` - `partner_account.account_id` Example: `owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321`
+  pageSize: integer, The maximum number of partner links to return. The service may return fewer than this value. If unspecified, at most 10 partner links will be returned. The maximum value is 100; values above 100 will be coerced to 100.
+  pageToken: string, A page token, received from a previous `SearchPartnerLinks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchPartnerLinks` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response from the SearchPartnerLinksRequest.
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "partnerLinks": [ # The partner links for the given account.
+    { # A partner link between an owning account and a partner account.
+      "name": "A String", # Identifier. The name of the partner link. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
+      "owningAccount": { # Represents a specific account. # Required. The owning account granting access to the partner account.
+        "accountId": "A String", # Required. The ID of the account. For example, your Google Ads account ID.
+        "accountType": "A String", # Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.
+        "product": "A String", # Deprecated. Use `account_type` instead.
+      },
+      "partnerAccount": { # Represents a specific account. # Required. The partner account granted access by the owning account.
+        "accountId": "A String", # Required. The ID of the account. For example, your Google Ads account ID.
+        "accountType": "A String", # Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.
+        "product": "A String", # Deprecated. Use `account_type` instead.
+      },
+      "partnerLinkId": "A String", # Output only. The partner link ID.
+    },
+  ],
+}
+
+ +
+ search_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.userListDirectLicenses.html b/docs/dyn/datamanager_v1.accountTypes.accounts.userListDirectLicenses.html new file mode 100644 index 00000000000..08cd5168d13 --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userListDirectLicenses.html @@ -0,0 +1,436 @@ + + + +

Data Manager API . accountTypes . accounts . userListDirectLicenses

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(parent, body=None, x__xgafv=None)

+

Creates a user list direct license. This feature is only available to data partners.

+

+ get(name, x__xgafv=None)

+

Retrieves a user list direct license. This feature is only available to data partners.

+

+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Lists all user list direct licenses owned by the parent account. This feature is only available to data partners.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(name, body=None, updateMask=None, x__xgafv=None)

+

Updates a user list direct license. This feature is only available to data partners.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ create(parent, body=None, x__xgafv=None) +
Creates a user list direct license. This feature is only available to data partners.
+
+Args:
+  parent: string, Required. The account that owns the user list being licensed. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A user list direct license. This feature is only available to data partners.
+  "clientAccountDisplayName": "A String", # Output only. Name of client customer which the user list is being licensed to. This field is read-only.
+  "clientAccountId": "A String", # Immutable. ID of client customer which the user list is being licensed to.
+  "clientAccountType": "A String", # Immutable. Account type of client customer which the user list is being licensed to.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list direct license.
+  "pricing": { # A user list license pricing. # Optional. UserListDirectLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListDirectLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list direct license. This feature is only available to data partners.
+  "clientAccountDisplayName": "A String", # Output only. Name of client customer which the user list is being licensed to. This field is read-only.
+  "clientAccountId": "A String", # Immutable. ID of client customer which the user list is being licensed to.
+  "clientAccountType": "A String", # Immutable. Account type of client customer which the user list is being licensed to.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list direct license.
+  "pricing": { # A user list license pricing. # Optional. UserListDirectLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListDirectLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+ +
+ get(name, x__xgafv=None) +
Retrieves a user list direct license. This feature is only available to data partners.
+
+Args:
+  name: string, Required. The resource name of the user list direct license. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list direct license. This feature is only available to data partners.
+  "clientAccountDisplayName": "A String", # Output only. Name of client customer which the user list is being licensed to. This field is read-only.
+  "clientAccountId": "A String", # Immutable. ID of client customer which the user list is being licensed to.
+  "clientAccountType": "A String", # Immutable. Account type of client customer which the user list is being licensed to.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list direct license.
+  "pricing": { # A user list license pricing. # Optional. UserListDirectLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListDirectLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+ +
+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) +
Lists all user list direct licenses owned by the parent account. This feature is only available to data partners.
+
+Args:
+  parent: string, Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} (required)
+  filter: string, Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`
+  pageSize: integer, Optional. The maximum number of licenses to return per page. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. A page token, received from a previous `ListUserListDirectLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response from the ListUserListDirectLicensesRequest.
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "userListDirectLicenses": [ # The licenses for the given user list in the request.
+    { # A user list direct license. This feature is only available to data partners.
+      "clientAccountDisplayName": "A String", # Output only. Name of client customer which the user list is being licensed to. This field is read-only.
+      "clientAccountId": "A String", # Immutable. ID of client customer which the user list is being licensed to.
+      "clientAccountType": "A String", # Immutable. Account type of client customer which the user list is being licensed to.
+      "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+        { # A user list license pricing.
+          "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+          "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+          "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+          "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+          "endTime": "A String", # Optional. End time of the pricing.
+          "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+          "pricingActive": True or False, # Output only. Whether this pricing is active.
+          "pricingId": "A String", # Output only. The ID of this pricing.
+          "startTime": "A String", # Output only. Start time of the pricing.
+        },
+      ],
+      "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call
+        "clickCount": "A String", # Output only. The number of clicks for the user list license.
+        "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+        "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+        "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+        "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+      },
+      "name": "A String", # Identifier. The resource name of the user list direct license.
+      "pricing": { # A user list license pricing. # Optional. UserListDirectLicense pricing.
+        "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+        "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+        "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+        "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+        "endTime": "A String", # Optional. End time of the pricing.
+        "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+        "pricingActive": True or False, # Output only. Whether this pricing is active.
+        "pricingId": "A String", # Output only. The ID of this pricing.
+        "startTime": "A String", # Output only. Start time of the pricing.
+      },
+      "status": "A String", # Optional. Status of UserListDirectLicense - ENABLED or DISABLED.
+      "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+      "userListId": "A String", # Immutable. ID of the user list being licensed.
+    },
+  ],
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ patch(name, body=None, updateMask=None, x__xgafv=None) +
Updates a user list direct license. This feature is only available to data partners.
+
+Args:
+  name: string, Identifier. The resource name of the user list direct license. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A user list direct license. This feature is only available to data partners.
+  "clientAccountDisplayName": "A String", # Output only. Name of client customer which the user list is being licensed to. This field is read-only.
+  "clientAccountId": "A String", # Immutable. ID of client customer which the user list is being licensed to.
+  "clientAccountType": "A String", # Immutable. Account type of client customer which the user list is being licensed to.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list direct license.
+  "pricing": { # A user list license pricing. # Optional. UserListDirectLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListDirectLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+  updateMask: string, Optional. The list of fields to update. The special character `*` is not supported and an `INVALID_UPDATE_MASK` error will be thrown if used.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list direct license. This feature is only available to data partners.
+  "clientAccountDisplayName": "A String", # Output only. Name of client customer which the user list is being licensed to. This field is read-only.
+  "clientAccountId": "A String", # Immutable. ID of client customer which the user list is being licensed to.
+  "clientAccountType": "A String", # Immutable. Account type of client customer which the user list is being licensed to.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list direct license.
+  "pricing": { # A user list license pricing. # Optional. UserListDirectLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListDirectLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html new file mode 100644 index 00000000000..9dfc3583773 --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.html @@ -0,0 +1,429 @@ + + + +

Data Manager API . accountTypes . accounts . userListGlobalLicenses

+

Instance Methods

+

+ userListGlobalLicenseCustomerInfos() +

+

Returns the userListGlobalLicenseCustomerInfos Resource.

+ +

+ close()

+

Close httplib2 connections.

+

+ create(parent, body=None, x__xgafv=None)

+

Creates a user list global license. This feature is only available to data partners.

+

+ get(name, x__xgafv=None)

+

Retrieves a user list global license. This feature is only available to data partners.

+

+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Lists all user list global licenses owned by the parent account. This feature is only available to data partners.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(name, body=None, updateMask=None, x__xgafv=None)

+

Updates a user list global license. This feature is only available to data partners.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ create(parent, body=None, x__xgafv=None) +
Creates a user list global license. This feature is only available to data partners.
+
+Args:
+  parent: string, Required. The account that owns the user list being licensed. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A user list global license. This feature is only available to data partners.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "licenseType": "A String", # Immutable. Product type of client customer which the user list is being licensed to.
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list global license.
+  "pricing": { # A user list license pricing. # Optional. UserListGlobalLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list global license. This feature is only available to data partners.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "licenseType": "A String", # Immutable. Product type of client customer which the user list is being licensed to.
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list global license.
+  "pricing": { # A user list license pricing. # Optional. UserListGlobalLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+ +
+ get(name, x__xgafv=None) +
Retrieves a user list global license. This feature is only available to data partners.
+
+Args:
+  name: string, Required. The resource name of the user list global license. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list global license. This feature is only available to data partners.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "licenseType": "A String", # Immutable. Product type of client customer which the user list is being licensed to.
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list global license.
+  "pricing": { # A user list license pricing. # Optional. UserListGlobalLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+ +
+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) +
Lists all user list global licenses owned by the parent account. This feature is only available to data partners.
+
+Args:
+  parent: string, Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} (required)
+  filter: string, Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`
+  pageSize: integer, Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. A page token, received from a previous `ListUserListGlobalLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response from the ListUserListGlobalLicensesRequest.
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "userListGlobalLicenses": [ # The licenses for the given user list in the request.
+    { # A user list global license. This feature is only available to data partners.
+      "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+        { # A user list license pricing.
+          "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+          "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+          "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+          "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+          "endTime": "A String", # Optional. End time of the pricing.
+          "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+          "pricingActive": True or False, # Output only. Whether this pricing is active.
+          "pricingId": "A String", # Output only. The ID of this pricing.
+          "startTime": "A String", # Output only. Start time of the pricing.
+        },
+      ],
+      "licenseType": "A String", # Immutable. Product type of client customer which the user list is being licensed to.
+      "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call
+        "clickCount": "A String", # Output only. The number of clicks for the user list license.
+        "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+        "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+        "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+        "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+      },
+      "name": "A String", # Identifier. The resource name of the user list global license.
+      "pricing": { # A user list license pricing. # Optional. UserListGlobalLicense pricing.
+        "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+        "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+        "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+        "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+        "endTime": "A String", # Optional. End time of the pricing.
+        "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+        "pricingActive": True or False, # Output only. Whether this pricing is active.
+        "pricingId": "A String", # Output only. The ID of this pricing.
+        "startTime": "A String", # Output only. Start time of the pricing.
+      },
+      "status": "A String", # Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.
+      "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+      "userListId": "A String", # Immutable. ID of the user list being licensed.
+    },
+  ],
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ patch(name, body=None, updateMask=None, x__xgafv=None) +
Updates a user list global license. This feature is only available to data partners.
+
+Args:
+  name: string, Identifier. The resource name of the user list global license. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A user list global license. This feature is only available to data partners.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "licenseType": "A String", # Immutable. Product type of client customer which the user list is being licensed to.
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list global license.
+  "pricing": { # A user list license pricing. # Optional. UserListGlobalLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+  updateMask: string, Optional. The list of fields to update. The special character `*` is not supported and an `INVALID_UPDATE_MASK` error will be thrown if used.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list global license. This feature is only available to data partners.
+  "historicalPricings": [ # Output only. Pricing history of this user list license. This field is read-only.
+    { # A user list license pricing.
+      "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+      "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+      "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+      "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+      "endTime": "A String", # Optional. End time of the pricing.
+      "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+      "pricingActive": True or False, # Output only. Whether this pricing is active.
+      "pricingId": "A String", # Output only. The ID of this pricing.
+      "startTime": "A String", # Output only. Start time of the pricing.
+    },
+  ],
+  "licenseType": "A String", # Immutable. Product type of client customer which the user list is being licensed to.
+  "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call
+    "clickCount": "A String", # Output only. The number of clicks for the user list license.
+    "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+    "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+    "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+    "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+  },
+  "name": "A String", # Identifier. The resource name of the user list global license.
+  "pricing": { # A user list license pricing. # Optional. UserListGlobalLicense pricing.
+    "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+    "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+    "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+    "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+    "endTime": "A String", # Optional. End time of the pricing.
+    "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+    "pricingActive": True or False, # Output only. Whether this pricing is active.
+    "pricingId": "A String", # Output only. The ID of this pricing.
+    "startTime": "A String", # Output only. Start time of the pricing.
+  },
+  "status": "A String", # Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.
+  "userListDisplayName": "A String", # Output only. Name of the user list being licensed. This field is read-only.
+  "userListId": "A String", # Immutable. ID of the user list being licensed.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html new file mode 100644 index 00000000000..7c4e873ff50 --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.html @@ -0,0 +1,171 @@ + + + +

Data Manager API . accountTypes . accounts . userListGlobalLicenses . userListGlobalLicenseCustomerInfos

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Lists all customer info for a user list global license. This feature is only available to data partners.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) +
Lists all customer info for a user list global license. This feature is only available to data partners.
+
+Args:
+  parent: string, Required. The global license whose customer info are being queried. Should be in the format `accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}`. To list all global license customer info under an account, replace the user list global license id with a '-' (for example, `accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-`) (required)
+  filter: string, Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`
+  pageSize: integer, Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. A page token, received from a previous `ListUserListDirectLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response from the ListUserListGlobalLicensesCustomerInfoRequest.
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "userListGlobalLicenseCustomerInfos": [ # The customer information for the given license in the request.
+    { # Information about a customer of a user list global license. This will automatically be created by the system when a customer purchases a global license.
+      "clientAccountDisplayName": "A String", # Output only. Name of client customer which the user list is being licensed to.
+      "clientAccountId": "A String", # Output only. ID of client customer which the user list is being licensed to.
+      "clientAccountType": "A String", # Output only. Product type of client customer which the user list is being licensed to.
+      "historicalPricings": [ # Output only. Pricing history of this user list license.
+        { # A user list license pricing.
+          "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+          "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+          "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+          "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+          "endTime": "A String", # Optional. End time of the pricing.
+          "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+          "pricingActive": True or False, # Output only. Whether this pricing is active.
+          "pricingId": "A String", # Output only. The ID of this pricing.
+          "startTime": "A String", # Output only. Start time of the pricing.
+        },
+      ],
+      "licenseType": "A String", # Output only. Product type of client customer which the user list is being licensed to.
+      "metrics": { # Metrics related to a user list license. # Output only. Metrics related to this license This field is only populated if the start and end dates are set in the ListUserListGlobalLicenseCustomerInfos call.
+        "clickCount": "A String", # Output only. The number of clicks for the user list license.
+        "endDate": "A String", # Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+        "impressionCount": "A String", # Output only. The number of impressions for the user list license.
+        "revenueUsdMicros": "A String", # Output only. The revenue for the user list license in USD micros.
+        "startDate": "A String", # Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.
+      },
+      "name": "A String", # Identifier. The resource name of the user list global license customer.
+      "pricing": { # A user list license pricing. # Output only. UserListDirectLicense pricing.
+        "buyerApprovalState": "A String", # Output only. The buyer approval state of this pricing. This field is read-only.
+        "costMicros": "A String", # Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.
+        "costType": "A String", # Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.
+        "currencyCode": "A String", # Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.
+        "endTime": "A String", # Optional. End time of the pricing.
+        "maxCostMicros": "A String", # Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.
+        "pricingActive": True or False, # Output only. Whether this pricing is active.
+        "pricingId": "A String", # Output only. The ID of this pricing.
+        "startTime": "A String", # Output only. Start time of the pricing.
+      },
+      "status": "A String", # Output only. Status of UserListDirectLicense - ENABLED or DISABLED.
+      "userListDisplayName": "A String", # Output only. Name of the user list being licensed.
+      "userListId": "A String", # Output only. ID of the user list being licensed.
+    },
+  ],
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.accountTypes.accounts.userLists.html b/docs/dyn/datamanager_v1.accountTypes.accounts.userLists.html new file mode 100644 index 00000000000..6cf0a8f4d66 --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.accounts.userLists.html @@ -0,0 +1,538 @@ + + + +

Data Manager API . accountTypes . accounts . userLists

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(parent, body=None, validateOnly=None, x__xgafv=None)

+

Creates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

+ delete(name, validateOnly=None, x__xgafv=None)

+

Deletes a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

+ get(name, x__xgafv=None)

+

Gets a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Lists UserLists. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

+

Updates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ create(parent, body=None, validateOnly=None, x__xgafv=None) +
Creates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  parent: string, Required. The parent account where this user list will be created. Format: accountTypes/{account_type}/accounts/{account} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A user list resource.
+  "accessReason": "A String", # Output only. The reason this account has been granted access to the list.
+  "accountAccessStatus": "A String", # Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.
+  "closingReason": "A String", # Output only. The reason why this user list membership status is closed.
+  "description": "A String", # Optional. A description of the user list.
+  "displayName": "A String", # Required. The display name of the user list.
+  "id": "A String", # Output only. The unique ID of the user list.
+  "ingestedUserListInfo": { # Represents a user list that is populated by user provided data. # Optional. Represents a user list that is populated by user ingested data.
+    "contactIdInfo": { # Additional information when `CONTACT_ID` is one of the `upload_key_types`. # Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data
+      "matchRatePercentage": 42, # Output only. Match rate for customer match user lists.
+    },
+    "mobileIdInfo": { # Additional information when `MOBILE_ID` is one of the `upload_key_types`. # Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`.
+      "appId": "A String", # Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+      "keySpace": "A String", # Required. Immutable. The key space of mobile IDs.
+    },
+    "pairIdInfo": { # Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners. # Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.
+      "advertiserIdentifierCount": "A String", # Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.
+      "cleanRoomIdentifier": "A String", # Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.
+      "matchRatePercentage": 42, # Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.
+      "publisherId": "A String", # Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.
+      "publisherName": "A String", # Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.
+    },
+    "partnerAudienceInfo": { # Additional information for partner audiences. This feature is only available to data partners. # Optional. Additional information for partner audiences. This feature is only available to data partners.
+      "commercePartner": "A String", # Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.
+      "partnerAudienceSource": "A String", # Required. Immutable. The source of the partner audience.
+    },
+    "pseudonymousIdInfo": { # Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`. # Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`.
+      "billableRecordCount": "A String", # Optional. Immutable. The number of billable records (e.g. uploaded or matched).
+      "syncStatus": "A String", # Output only. Sync status of the user list.
+    },
+    "uploadKeyTypes": [ # Required. Immutable. Upload key types of this user list.
+      "A String",
+    ],
+    "userIdInfo": { # Additional information when `USER_ID` is one of the `upload_key_types`. # Optional. Additional information when `USER_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+    },
+  },
+  "integrationCode": "A String", # Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.
+  "membershipDuration": "A String", # Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.
+  "membershipStatus": "A String", # Optional. Membership status of this user list.
+  "name": "A String", # Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
+  "readOnly": True or False, # Output only. An option that indicates if a user may edit a list.
+  "sizeInfo": { # Estimated number of members in this user list in different target networks. # Output only. Estimated number of members in this user list in different target networks.
+    "displayNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list, on the Google Display Network.
+    "searchNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.
+  },
+  "targetNetworkInfo": { # Eligibility information for different target networks. # Optional. Eligibility information for different target networks.
+    "eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network.
+    "eligibleForSearch": True or False, # Optional. Indicates if this user list is eligible for Google Search Network.
+  },
+}
+
+  validateOnly: boolean, Optional. If true, the request is validated but not executed.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list resource.
+  "accessReason": "A String", # Output only. The reason this account has been granted access to the list.
+  "accountAccessStatus": "A String", # Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.
+  "closingReason": "A String", # Output only. The reason why this user list membership status is closed.
+  "description": "A String", # Optional. A description of the user list.
+  "displayName": "A String", # Required. The display name of the user list.
+  "id": "A String", # Output only. The unique ID of the user list.
+  "ingestedUserListInfo": { # Represents a user list that is populated by user provided data. # Optional. Represents a user list that is populated by user ingested data.
+    "contactIdInfo": { # Additional information when `CONTACT_ID` is one of the `upload_key_types`. # Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data
+      "matchRatePercentage": 42, # Output only. Match rate for customer match user lists.
+    },
+    "mobileIdInfo": { # Additional information when `MOBILE_ID` is one of the `upload_key_types`. # Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`.
+      "appId": "A String", # Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+      "keySpace": "A String", # Required. Immutable. The key space of mobile IDs.
+    },
+    "pairIdInfo": { # Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners. # Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.
+      "advertiserIdentifierCount": "A String", # Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.
+      "cleanRoomIdentifier": "A String", # Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.
+      "matchRatePercentage": 42, # Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.
+      "publisherId": "A String", # Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.
+      "publisherName": "A String", # Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.
+    },
+    "partnerAudienceInfo": { # Additional information for partner audiences. This feature is only available to data partners. # Optional. Additional information for partner audiences. This feature is only available to data partners.
+      "commercePartner": "A String", # Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.
+      "partnerAudienceSource": "A String", # Required. Immutable. The source of the partner audience.
+    },
+    "pseudonymousIdInfo": { # Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`. # Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`.
+      "billableRecordCount": "A String", # Optional. Immutable. The number of billable records (e.g. uploaded or matched).
+      "syncStatus": "A String", # Output only. Sync status of the user list.
+    },
+    "uploadKeyTypes": [ # Required. Immutable. Upload key types of this user list.
+      "A String",
+    ],
+    "userIdInfo": { # Additional information when `USER_ID` is one of the `upload_key_types`. # Optional. Additional information when `USER_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+    },
+  },
+  "integrationCode": "A String", # Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.
+  "membershipDuration": "A String", # Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.
+  "membershipStatus": "A String", # Optional. Membership status of this user list.
+  "name": "A String", # Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
+  "readOnly": True or False, # Output only. An option that indicates if a user may edit a list.
+  "sizeInfo": { # Estimated number of members in this user list in different target networks. # Output only. Estimated number of members in this user list in different target networks.
+    "displayNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list, on the Google Display Network.
+    "searchNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.
+  },
+  "targetNetworkInfo": { # Eligibility information for different target networks. # Optional. Eligibility information for different target networks.
+    "eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network.
+    "eligibleForSearch": True or False, # Optional. Indicates if this user list is eligible for Google Search Network.
+  },
+}
+
+ +
+ delete(name, validateOnly=None, x__xgafv=None) +
Deletes a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  name: string, Required. The name of the user list to delete. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} (required)
+  validateOnly: boolean, Optional. If true, the request is validated but not executed.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
+}
+
+ +
+ get(name, x__xgafv=None) +
Gets a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  name: string, Required. The resource name of the UserList to retrieve. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list resource.
+  "accessReason": "A String", # Output only. The reason this account has been granted access to the list.
+  "accountAccessStatus": "A String", # Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.
+  "closingReason": "A String", # Output only. The reason why this user list membership status is closed.
+  "description": "A String", # Optional. A description of the user list.
+  "displayName": "A String", # Required. The display name of the user list.
+  "id": "A String", # Output only. The unique ID of the user list.
+  "ingestedUserListInfo": { # Represents a user list that is populated by user provided data. # Optional. Represents a user list that is populated by user ingested data.
+    "contactIdInfo": { # Additional information when `CONTACT_ID` is one of the `upload_key_types`. # Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data
+      "matchRatePercentage": 42, # Output only. Match rate for customer match user lists.
+    },
+    "mobileIdInfo": { # Additional information when `MOBILE_ID` is one of the `upload_key_types`. # Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`.
+      "appId": "A String", # Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+      "keySpace": "A String", # Required. Immutable. The key space of mobile IDs.
+    },
+    "pairIdInfo": { # Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners. # Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.
+      "advertiserIdentifierCount": "A String", # Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.
+      "cleanRoomIdentifier": "A String", # Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.
+      "matchRatePercentage": 42, # Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.
+      "publisherId": "A String", # Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.
+      "publisherName": "A String", # Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.
+    },
+    "partnerAudienceInfo": { # Additional information for partner audiences. This feature is only available to data partners. # Optional. Additional information for partner audiences. This feature is only available to data partners.
+      "commercePartner": "A String", # Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.
+      "partnerAudienceSource": "A String", # Required. Immutable. The source of the partner audience.
+    },
+    "pseudonymousIdInfo": { # Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`. # Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`.
+      "billableRecordCount": "A String", # Optional. Immutable. The number of billable records (e.g. uploaded or matched).
+      "syncStatus": "A String", # Output only. Sync status of the user list.
+    },
+    "uploadKeyTypes": [ # Required. Immutable. Upload key types of this user list.
+      "A String",
+    ],
+    "userIdInfo": { # Additional information when `USER_ID` is one of the `upload_key_types`. # Optional. Additional information when `USER_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+    },
+  },
+  "integrationCode": "A String", # Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.
+  "membershipDuration": "A String", # Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.
+  "membershipStatus": "A String", # Optional. Membership status of this user list.
+  "name": "A String", # Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
+  "readOnly": True or False, # Output only. An option that indicates if a user may edit a list.
+  "sizeInfo": { # Estimated number of members in this user list in different target networks. # Output only. Estimated number of members in this user list in different target networks.
+    "displayNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list, on the Google Display Network.
+    "searchNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.
+  },
+  "targetNetworkInfo": { # Eligibility information for different target networks. # Optional. Eligibility information for different target networks.
+    "eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network.
+    "eligibleForSearch": True or False, # Optional. Indicates if this user list is eligible for Google Search Network.
+  },
+}
+
+ +
+ list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) +
Lists UserLists. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  parent: string, Required. The parent account which owns this collection of user lists. Format: accountTypes/{account_type}/accounts/{account} (required)
+  filter: string, Optional. A [filter string](//google.aip.dev/160). All fields need to be on the left hand side of each condition (for example: `display_name = "list 1"`). Supported operations: - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` - `:` (has) Supported fields: - `id` - `display_name` - `description` - `membership_status` - `integration_code` - `access_reason` - `ingested_user_list_info.upload_key_types`
+  pageSize: integer, Optional. The maximum number of user lists to return. The service may return fewer than this value. If unspecified, at most 50 user lists will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. A page token, received from a previous `ListUserLists` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLists` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for ListUserLists.
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "userLists": [ # The user lists from the specified account.
+    { # A user list resource.
+      "accessReason": "A String", # Output only. The reason this account has been granted access to the list.
+      "accountAccessStatus": "A String", # Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.
+      "closingReason": "A String", # Output only. The reason why this user list membership status is closed.
+      "description": "A String", # Optional. A description of the user list.
+      "displayName": "A String", # Required. The display name of the user list.
+      "id": "A String", # Output only. The unique ID of the user list.
+      "ingestedUserListInfo": { # Represents a user list that is populated by user provided data. # Optional. Represents a user list that is populated by user ingested data.
+        "contactIdInfo": { # Additional information when `CONTACT_ID` is one of the `upload_key_types`. # Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`.
+          "dataSourceType": "A String", # Optional. Immutable. Source of the upload data
+          "matchRatePercentage": 42, # Output only. Match rate for customer match user lists.
+        },
+        "mobileIdInfo": { # Additional information when `MOBILE_ID` is one of the `upload_key_types`. # Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`.
+          "appId": "A String", # Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.
+          "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+          "keySpace": "A String", # Required. Immutable. The key space of mobile IDs.
+        },
+        "pairIdInfo": { # Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners. # Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.
+          "advertiserIdentifierCount": "A String", # Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.
+          "cleanRoomIdentifier": "A String", # Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.
+          "matchRatePercentage": 42, # Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.
+          "publisherId": "A String", # Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.
+          "publisherName": "A String", # Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.
+        },
+        "partnerAudienceInfo": { # Additional information for partner audiences. This feature is only available to data partners. # Optional. Additional information for partner audiences. This feature is only available to data partners.
+          "commercePartner": "A String", # Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.
+          "partnerAudienceSource": "A String", # Required. Immutable. The source of the partner audience.
+        },
+        "pseudonymousIdInfo": { # Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`. # Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`.
+          "billableRecordCount": "A String", # Optional. Immutable. The number of billable records (e.g. uploaded or matched).
+          "syncStatus": "A String", # Output only. Sync status of the user list.
+        },
+        "uploadKeyTypes": [ # Required. Immutable. Upload key types of this user list.
+          "A String",
+        ],
+        "userIdInfo": { # Additional information when `USER_ID` is one of the `upload_key_types`. # Optional. Additional information when `USER_ID` is one of the `upload_key_types`.
+          "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+        },
+      },
+      "integrationCode": "A String", # Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.
+      "membershipDuration": "A String", # Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.
+      "membershipStatus": "A String", # Optional. Membership status of this user list.
+      "name": "A String", # Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
+      "readOnly": True or False, # Output only. An option that indicates if a user may edit a list.
+      "sizeInfo": { # Estimated number of members in this user list in different target networks. # Output only. Estimated number of members in this user list in different target networks.
+        "displayNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list, on the Google Display Network.
+        "searchNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.
+      },
+      "targetNetworkInfo": { # Eligibility information for different target networks. # Optional. Eligibility information for different target networks.
+        "eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network.
+        "eligibleForSearch": True or False, # Optional. Indicates if this user list is eligible for Google Search Network.
+      },
+    },
+  ],
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ patch(name, body=None, updateMask=None, validateOnly=None, x__xgafv=None) +
Updates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
+
+Args:
+  name: string, Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A user list resource.
+  "accessReason": "A String", # Output only. The reason this account has been granted access to the list.
+  "accountAccessStatus": "A String", # Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.
+  "closingReason": "A String", # Output only. The reason why this user list membership status is closed.
+  "description": "A String", # Optional. A description of the user list.
+  "displayName": "A String", # Required. The display name of the user list.
+  "id": "A String", # Output only. The unique ID of the user list.
+  "ingestedUserListInfo": { # Represents a user list that is populated by user provided data. # Optional. Represents a user list that is populated by user ingested data.
+    "contactIdInfo": { # Additional information when `CONTACT_ID` is one of the `upload_key_types`. # Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data
+      "matchRatePercentage": 42, # Output only. Match rate for customer match user lists.
+    },
+    "mobileIdInfo": { # Additional information when `MOBILE_ID` is one of the `upload_key_types`. # Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`.
+      "appId": "A String", # Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+      "keySpace": "A String", # Required. Immutable. The key space of mobile IDs.
+    },
+    "pairIdInfo": { # Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners. # Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.
+      "advertiserIdentifierCount": "A String", # Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.
+      "cleanRoomIdentifier": "A String", # Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.
+      "matchRatePercentage": 42, # Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.
+      "publisherId": "A String", # Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.
+      "publisherName": "A String", # Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.
+    },
+    "partnerAudienceInfo": { # Additional information for partner audiences. This feature is only available to data partners. # Optional. Additional information for partner audiences. This feature is only available to data partners.
+      "commercePartner": "A String", # Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.
+      "partnerAudienceSource": "A String", # Required. Immutable. The source of the partner audience.
+    },
+    "pseudonymousIdInfo": { # Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`. # Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`.
+      "billableRecordCount": "A String", # Optional. Immutable. The number of billable records (e.g. uploaded or matched).
+      "syncStatus": "A String", # Output only. Sync status of the user list.
+    },
+    "uploadKeyTypes": [ # Required. Immutable. Upload key types of this user list.
+      "A String",
+    ],
+    "userIdInfo": { # Additional information when `USER_ID` is one of the `upload_key_types`. # Optional. Additional information when `USER_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+    },
+  },
+  "integrationCode": "A String", # Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.
+  "membershipDuration": "A String", # Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.
+  "membershipStatus": "A String", # Optional. Membership status of this user list.
+  "name": "A String", # Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
+  "readOnly": True or False, # Output only. An option that indicates if a user may edit a list.
+  "sizeInfo": { # Estimated number of members in this user list in different target networks. # Output only. Estimated number of members in this user list in different target networks.
+    "displayNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list, on the Google Display Network.
+    "searchNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.
+  },
+  "targetNetworkInfo": { # Eligibility information for different target networks. # Optional. Eligibility information for different target networks.
+    "eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network.
+    "eligibleForSearch": True or False, # Optional. Indicates if this user list is eligible for Google Search Network.
+  },
+}
+
+  updateMask: string, Optional. The list of fields to update.
+  validateOnly: boolean, Optional. If true, the request is validated but not executed.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A user list resource.
+  "accessReason": "A String", # Output only. The reason this account has been granted access to the list.
+  "accountAccessStatus": "A String", # Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.
+  "closingReason": "A String", # Output only. The reason why this user list membership status is closed.
+  "description": "A String", # Optional. A description of the user list.
+  "displayName": "A String", # Required. The display name of the user list.
+  "id": "A String", # Output only. The unique ID of the user list.
+  "ingestedUserListInfo": { # Represents a user list that is populated by user provided data. # Optional. Represents a user list that is populated by user ingested data.
+    "contactIdInfo": { # Additional information when `CONTACT_ID` is one of the `upload_key_types`. # Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data
+      "matchRatePercentage": 42, # Output only. Match rate for customer match user lists.
+    },
+    "mobileIdInfo": { # Additional information when `MOBILE_ID` is one of the `upload_key_types`. # Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`.
+      "appId": "A String", # Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+      "keySpace": "A String", # Required. Immutable. The key space of mobile IDs.
+    },
+    "pairIdInfo": { # Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners. # Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.
+      "advertiserIdentifierCount": "A String", # Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.
+      "cleanRoomIdentifier": "A String", # Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.
+      "matchRatePercentage": 42, # Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.
+      "publisherId": "A String", # Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.
+      "publisherName": "A String", # Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.
+    },
+    "partnerAudienceInfo": { # Additional information for partner audiences. This feature is only available to data partners. # Optional. Additional information for partner audiences. This feature is only available to data partners.
+      "commercePartner": "A String", # Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.
+      "partnerAudienceSource": "A String", # Required. Immutable. The source of the partner audience.
+    },
+    "pseudonymousIdInfo": { # Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`. # Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`.
+      "billableRecordCount": "A String", # Optional. Immutable. The number of billable records (e.g. uploaded or matched).
+      "syncStatus": "A String", # Output only. Sync status of the user list.
+    },
+    "uploadKeyTypes": [ # Required. Immutable. Upload key types of this user list.
+      "A String",
+    ],
+    "userIdInfo": { # Additional information when `USER_ID` is one of the `upload_key_types`. # Optional. Additional information when `USER_ID` is one of the `upload_key_types`.
+      "dataSourceType": "A String", # Optional. Immutable. Source of the upload data.
+    },
+  },
+  "integrationCode": "A String", # Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.
+  "membershipDuration": "A String", # Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.
+  "membershipStatus": "A String", # Optional. Membership status of this user list.
+  "name": "A String", # Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
+  "readOnly": True or False, # Output only. An option that indicates if a user may edit a list.
+  "sizeInfo": { # Estimated number of members in this user list in different target networks. # Output only. Estimated number of members in this user list in different target networks.
+    "displayNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list, on the Google Display Network.
+    "searchNetworkMembersCount": "A String", # Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.
+  },
+  "targetNetworkInfo": { # Eligibility information for different target networks. # Optional. Eligibility information for different target networks.
+    "eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network.
+    "eligibleForSearch": True or False, # Optional. Indicates if this user list is eligible for Google Search Network.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.accountTypes.html b/docs/dyn/datamanager_v1.accountTypes.html new file mode 100644 index 00000000000..83957180a0b --- /dev/null +++ b/docs/dyn/datamanager_v1.accountTypes.html @@ -0,0 +1,91 @@ + + + +

Data Manager API . accountTypes

+

Instance Methods

+

+ accounts() +

+

Returns the accounts Resource.

+ +

+ close()

+

Close httplib2 connections.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ + \ No newline at end of file diff --git a/docs/dyn/datamanager_v1.audienceMembers.html b/docs/dyn/datamanager_v1.audienceMembers.html index 342d814fa96..bf38e52c4cb 100644 --- a/docs/dyn/datamanager_v1.audienceMembers.html +++ b/docs/dyn/datamanager_v1.audienceMembers.html @@ -112,11 +112,16 @@

Method Details

"A String", ], }, - "pairData": { # [PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required. # [Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908). + "pairData": { # [PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required. This feature is only available to data partners. # [Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908). This feature is only available to data partners. "pairIds": [ # Required. Cleanroom-provided PII data, hashed with SHA256, and encrypted with an EC commutative cipher using publisher key for the [PAIR]((//support.google.com/admanager/answer/15067908)) user list. At most 10 `pairIds` can be provided in a single AudienceMember. "A String", ], }, + "ppidData": { # Publisher provided identifiers data holding the ppids. At least one ppid is required. This feature is only available to data partners. # Data related to publisher provided identifiers. This feature is only available to data partners. + "ppids": [ # Required. The list of publisher provided identifiers for a user. + "A String", + ], + }, "userData": { # Data that identifies the user. At least one identifier is required. # User-provided data that identifies the user. "userIdentifiers": [ # Required. The identifiers for the user. It's possible to provide multiple instances of the same type of data (for example, multiple email addresses). To increase the likelihood of a match, provide as many identifiers as possible. At most 10 `userIdentifiers` can be provided in a single AudienceMember or Event. { # A single identifier for the user. @@ -131,6 +136,9 @@

Method Details

}, ], }, + "userIdData": { # User id data holding the user id. # Data related to unique identifiers for a user, as defined by the advertiser. + "userId": "A String", # Required. A unique identifier for a user, as defined by the advertiser. + }, }, ], "consent": { # [Digital Markets Act (DMA)](//digital-markets-act.ec.europa.eu/index_en) consent settings for the user. # Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each AudienceMember. @@ -215,11 +223,16 @@

Method Details

"A String", ], }, - "pairData": { # [PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required. # [Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908). + "pairData": { # [PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required. This feature is only available to data partners. # [Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908). This feature is only available to data partners. "pairIds": [ # Required. Cleanroom-provided PII data, hashed with SHA256, and encrypted with an EC commutative cipher using publisher key for the [PAIR]((//support.google.com/admanager/answer/15067908)) user list. At most 10 `pairIds` can be provided in a single AudienceMember. "A String", ], }, + "ppidData": { # Publisher provided identifiers data holding the ppids. At least one ppid is required. This feature is only available to data partners. # Data related to publisher provided identifiers. This feature is only available to data partners. + "ppids": [ # Required. The list of publisher provided identifiers for a user. + "A String", + ], + }, "userData": { # Data that identifies the user. At least one identifier is required. # User-provided data that identifies the user. "userIdentifiers": [ # Required. The identifiers for the user. It's possible to provide multiple instances of the same type of data (for example, multiple email addresses). To increase the likelihood of a match, provide as many identifiers as possible. At most 10 `userIdentifiers` can be provided in a single AudienceMember or Event. { # A single identifier for the user. @@ -234,6 +247,9 @@

Method Details

}, ], }, + "userIdData": { # User id data holding the user id. # Data related to unique identifiers for a user, as defined by the advertiser. + "userId": "A String", # Required. A unique identifier for a user, as defined by the advertiser. + }, }, ], "destinations": [ # Required. The list of destinations to remove the users from. diff --git a/docs/dyn/datamanager_v1.html b/docs/dyn/datamanager_v1.html index f757499f8e9..591cc2fa1a2 100644 --- a/docs/dyn/datamanager_v1.html +++ b/docs/dyn/datamanager_v1.html @@ -74,6 +74,11 @@

Data Manager API

Instance Methods

+

+ accountTypes() +

+

Returns the accountTypes Resource.

+

audienceMembers()

diff --git a/docs/dyn/datamanager_v1.requestStatus.html b/docs/dyn/datamanager_v1.requestStatus.html index cc2111b0d09..3c9fd359d94 100644 --- a/docs/dyn/datamanager_v1.requestStatus.html +++ b/docs/dyn/datamanager_v1.requestStatus.html @@ -112,11 +112,19 @@

Method Details

"pairIdCount": "A String", # The total count of pair ids sent in the upload request for the destination. Includes all pair ids in the request, regardless of whether they were successfully ingested or not. "recordCount": "A String", # The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not. }, + "ppidDataIngestionStatus": { # The status of the ppid data ingestion to the destination containing stats related to the ingestion. # The status of the ppid data ingestion to the destination. + "ppidCount": "A String", # The total count of ppids sent in the upload request for the destination. Includes all ppids in the request, regardless of whether they were successfully ingested or not. + "recordCount": "A String", # The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not. + }, "userDataIngestionStatus": { # The status of the user data ingestion to the destination containing stats related to the ingestion. # The status of the user data ingestion to the destination. "recordCount": "A String", # The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not. "uploadMatchRateRange": "A String", # The match rate range of the upload. "userIdentifierCount": "A String", # The total count of user identifiers sent in the upload request for the destination. Includes all user identifiers in the request, regardless of whether they were successfully ingested or not. }, + "userIdDataIngestionStatus": { # The status of the user id data ingestion to the destination containing stats related to the ingestion. # The status of the user id data ingestion to the destination. + "recordCount": "A String", # The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not. + "userIdCount": "A String", # The total count of user ids sent in the upload request for the destination. Includes all user ids in the request, regardless of whether they were successfully ingested or not. + }, }, "audienceMembersRemovalStatus": { # The status of the remove audience members request. # The status of the remove audience members request. "mobileDataRemovalStatus": { # The status of the mobile data removal from the destination. # The status of the mobile data removal from the destination. @@ -127,10 +135,18 @@

Method Details

"pairIdCount": "A String", # The total count of pair ids sent in the removal request. Includes all pair ids in the request, regardless of whether they were successfully removed or not. "recordCount": "A String", # The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not. }, + "ppidDataRemovalStatus": { # The status of the ppid data removal from the destination. # The status of the ppid data removal from the destination. + "ppidCount": "A String", # The total count of ppids sent in the removal request. Includes all ppids in the request, regardless of whether they were successfully removed or not. + "recordCount": "A String", # The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not. + }, "userDataRemovalStatus": { # The status of the user data removal from the destination. # The status of the user data removal from the destination. "recordCount": "A String", # The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not. "userIdentifierCount": "A String", # The total count of user identifiers sent in the removal request. Includes all user identifiers in the request, regardless of whether they were successfully removed or not. }, + "userIdDataRemovalStatus": { # The status of the user id data removal from the destination. # The status of the user id data removal from the destination. + "recordCount": "A String", # The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not. + "userIdCount": "A String", # The total count of user ids sent in the removal request. Includes all user ids in the request, regardless of whether they were successfully removed or not. + }, }, "destination": { # The Google product you're sending data to. For example, a Google Ads account. # A destination within a DM API request. "linkedAccount": { # Represents a specific account. # Optional. An account that the calling user's `login_account` has access to, through an established account link. For example, a data partner's `login_account` might have access to a client's `linked_account`. The partner might use this field to send data from the `linked_account` to another `operating_account`. diff --git a/googleapiclient/discovery_cache/documents/datamanager.v1.json b/googleapiclient/discovery_cache/documents/datamanager.v1.json index aa3c1588c20..e3d315bffff 100644 --- a/googleapiclient/discovery_cache/documents/datamanager.v1.json +++ b/googleapiclient/discovery_cache/documents/datamanager.v1.json @@ -105,642 +105,2120 @@ }, "protocol": "rest", "resources": { -"audienceMembers": { +"accountTypes": { +"resources": { +"accounts": { +"resources": { +"insights": { "methods": { -"ingest": { -"description": "Uploads a list of AudienceMember resources to the provided Destination.", -"flatPath": "v1/audienceMembers:ingest", +"retrieve": { +"description": "Retrieves marketing data insights for a given user list. This feature is only available to data partners. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/insights:retrieve", "httpMethod": "POST", -"id": "datamanager.audienceMembers.ingest", -"parameterOrder": [], -"parameters": {}, -"path": "v1/audienceMembers:ingest", +"id": "datamanager.accountTypes.accounts.insights.retrieve", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The parent account that owns the user list. Format: `accountTypes/{account_type}/accounts/{account}`", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/insights:retrieve", "request": { -"$ref": "IngestAudienceMembersRequest" +"$ref": "RetrieveInsightsRequest" }, "response": { -"$ref": "IngestAudienceMembersResponse" +"$ref": "RetrieveInsightsResponse" }, "scopes": [ "https://www.googleapis.com/auth/datamanager" ] +} +} }, -"remove": { -"description": "Removes a list of AudienceMember resources from the provided Destination.", -"flatPath": "v1/audienceMembers:remove", +"partnerLinks": { +"methods": { +"create": { +"description": "Creates a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/partnerLinks", "httpMethod": "POST", -"id": "datamanager.audienceMembers.remove", -"parameterOrder": [], -"parameters": {}, -"path": "v1/audienceMembers:remove", +"id": "datamanager.accountTypes.accounts.partnerLinks.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The parent, which owns this collection of partner links. Format: accountTypes/{account_type}/accounts/{account}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/partnerLinks", "request": { -"$ref": "RemoveAudienceMembersRequest" +"$ref": "PartnerLink" }, "response": { -"$ref": "RemoveAudienceMembersResponse" +"$ref": "PartnerLink" }, "scopes": [ "https://www.googleapis.com/auth/datamanager" ] -} -} }, -"events": { -"methods": { -"ingest": { -"description": "Uploads a list of Event resources from the provided Destination.", -"flatPath": "v1/events:ingest", -"httpMethod": "POST", -"id": "datamanager.events.ingest", -"parameterOrder": [], -"parameters": {}, -"path": "v1/events:ingest", -"request": { -"$ref": "IngestEventsRequest" +"delete": { +"description": "Deletes a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/partnerLinks/{partnerLinksId}", +"httpMethod": "DELETE", +"id": "datamanager.accountTypes.accounts.partnerLinks.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the partner link to delete. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/partnerLinks/[^/]+$", +"required": true, +"type": "string" +} }, +"path": "v1/{+name}", "response": { -"$ref": "IngestEventsResponse" +"$ref": "Empty" }, "scopes": [ "https://www.googleapis.com/auth/datamanager" ] -} -} }, -"requestStatus": { -"methods": { -"retrieve": { -"description": "Gets the status of a request given request id.", -"flatPath": "v1/requestStatus:retrieve", +"search": { +"description": "Searches for all partner links to and from a given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/partnerLinks:search", "httpMethod": "GET", -"id": "datamanager.requestStatus.retrieve", -"parameterOrder": [], +"id": "datamanager.accountTypes.accounts.partnerLinks.search", +"parameterOrder": [ +"parent" +], "parameters": { -"requestId": { -"description": "Required. Required. The request ID of the Data Manager API request.", +"filter": { +"description": "Optional. A [filter string](//google.aip.dev/160). All fields need to be on the left hand side of each condition (for example: `partner_link_id = 123456789`). Supported operations: - `AND` - `=` - `!=` Supported fields: - `partner_link_id` - `owning_account.account_type` - `owning_account.account_id` - `partner_account.account_type` - `partner_account.account_id` Example: `owning_account.account_type = \"GOOGLE_ADS\" OR partner_account.account_id = 987654321`", +"location": "query", +"type": "string" +}, +"pageSize": { +"description": "The maximum number of partner links to return. The service may return fewer than this value. If unspecified, at most 10 partner links will be returned. The maximum value is 100; values above 100 will be coerced to 100.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "A page token, received from a previous `SearchPartnerLinks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchPartnerLinks` must match the call that provided the page token.", "location": "query", "type": "string" +}, +"parent": { +"description": "Required. Account to search for partner links. If no `filter` is specified, all partner links where this account is either the `owning_account` or `partner_account` are returned. Format: `accountTypes/{account_type}/accounts/{account}`", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, +"type": "string" } }, -"path": "v1/requestStatus:retrieve", +"path": "v1/{+parent}/partnerLinks:search", "response": { -"$ref": "RetrieveRequestStatusResponse" +"$ref": "SearchPartnerLinksResponse" }, "scopes": [ "https://www.googleapis.com/auth/datamanager" ] } } -} }, -"revision": "20260102", -"rootUrl": "https://datamanager.googleapis.com/", -"schemas": { -"AdIdentifiers": { -"description": "Identifiers and other information used to match the conversion event with other online activity (such as ad clicks).", -"id": "AdIdentifiers", -"properties": { -"gbraid": { -"description": "Optional. The click identifier for clicks associated with app events and originating from iOS devices starting with iOS14.", +"userListDirectLicenses": { +"methods": { +"create": { +"description": "Creates a user list direct license. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses", +"httpMethod": "POST", +"id": "datamanager.accountTypes.accounts.userListDirectLicenses.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The account that owns the user list being licensed. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, "type": "string" +} }, -"gclid": { -"description": "Optional. The Google click ID (gclid) associated with this event.", -"type": "string" +"path": "v1/{+parent}/userListDirectLicenses", +"request": { +"$ref": "UserListDirectLicense" }, -"landingPageDeviceInfo": { -"$ref": "DeviceInfo", -"description": "Optional. Information gathered about the device being used (if any) at the time of landing onto the advertiser\u2019s site after interacting with the ad." +"response": { +"$ref": "UserListDirectLicense" }, -"sessionAttributes": { -"description": "Optional. Session attributes for event attribution and modeling.", -"type": "string" +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] }, -"wbraid": { -"description": "Optional. The click identifier for clicks associated with web events and originating from iOS devices starting with iOS14.", +"get": { +"description": "Retrieves a user list direct license. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses/{userListDirectLicensesId}", +"httpMethod": "GET", +"id": "datamanager.accountTypes.accounts.userListDirectLicenses.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the user list direct license.", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListDirectLicenses/[^/]+$", +"required": true, "type": "string" } }, -"type": "object" +"path": "v1/{+name}", +"response": { +"$ref": "UserListDirectLicense" }, -"AddressInfo": { -"description": "Address information for the user.", -"id": "AddressInfo", -"properties": { -"familyName": { -"description": "Required. Family (last) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256.", -"type": "string" +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] }, -"givenName": { -"description": "Required. Given (first) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256.", +"list": { +"description": "Lists all user list direct licenses owned by the parent account. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses", +"httpMethod": "GET", +"id": "datamanager.accountTypes.accounts.userListDirectLicenses.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"filter": { +"description": "Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`", +"location": "query", "type": "string" }, -"postalCode": { -"description": "Required. The postal code of the user's address.", +"pageSize": { +"description": "Optional. The maximum number of licenses to return per page. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. A page token, received from a previous `ListUserListDirectLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.", +"location": "query", "type": "string" }, -"regionCode": { -"description": "Required. The 2-letter region code in ISO-3166-1 alpha-2 of the user's address.", +"parent": { +"description": "Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, "type": "string" } }, -"type": "object" +"path": "v1/{+parent}/userListDirectLicenses", +"response": { +"$ref": "ListUserListDirectLicensesResponse" }, -"AudienceMember": { -"description": "The audience member to be operated on.", -"id": "AudienceMember", -"properties": { -"consent": { -"$ref": "Consent", -"description": "Optional. The consent setting for the user." +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] }, -"destinationReferences": { -"description": "Optional. Defines which Destination to send the audience member to.", -"items": { +"patch": { +"description": "Updates a user list direct license. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses/{userListDirectLicensesId}", +"httpMethod": "PATCH", +"id": "datamanager.accountTypes.accounts.userListDirectLicenses.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The resource name of the user list direct license.", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListDirectLicenses/[^/]+$", +"required": true, "type": "string" }, -"type": "array" +"updateMask": { +"description": "Optional. The list of fields to update. The special character `*` is not supported and an `INVALID_UPDATE_MASK` error will be thrown if used.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} }, -"mobileData": { -"$ref": "MobileData", -"description": "Data identifying the user's mobile devices." +"path": "v1/{+name}", +"request": { +"$ref": "UserListDirectLicense" }, -"pairData": { -"$ref": "PairData", -"description": "[Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908)." +"response": { +"$ref": "UserListDirectLicense" }, -"userData": { -"$ref": "UserData", -"description": "User-provided data that identifies the user." +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +} } }, -"type": "object" -}, -"AwsWrappedKeyInfo": { -"description": "A data encryption key wrapped by an AWS KMS key.", -"id": "AwsWrappedKeyInfo", -"properties": { -"encryptedDek": { -"description": "Required. The base64 encoded encrypted data encryption key.", +"userListGlobalLicenses": { +"methods": { +"create": { +"description": "Creates a user list global license. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses", +"httpMethod": "POST", +"id": "datamanager.accountTypes.accounts.userListGlobalLicenses.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The account that owns the user list being licensed. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, "type": "string" +} }, -"kekUri": { -"description": "Required. The URI of the AWS KMS key used to decrypt the DEK. Should be in the format of `arn:{partition}:kms:{region}:{account_id}:key/{key_id}` or `aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}`", -"type": "string" +"path": "v1/{+parent}/userListGlobalLicenses", +"request": { +"$ref": "UserListGlobalLicense" }, -"keyType": { -"description": "Required. The type of algorithm used to encrypt the data.", -"enum": [ -"KEY_TYPE_UNSPECIFIED", -"XCHACHA20_POLY1305" -], -"enumDescriptions": [ -"Unspecified key type. Should never be used.", -"Algorithm XChaCha20-Poly1305" -], -"type": "string" +"response": { +"$ref": "UserListGlobalLicense" }, -"roleArn": { -"description": "Required. The Amazon Resource Name of the IAM Role to assume for KMS decryption access. Should be in the format of `arn:{partition}:iam::{account_id}:role/{role_name}`", +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +}, +"get": { +"description": "Retrieves a user list global license. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses/{userListGlobalLicensesId}", +"httpMethod": "GET", +"id": "datamanager.accountTypes.accounts.userListGlobalLicenses.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the user list global license.", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListGlobalLicenses/[^/]+$", +"required": true, "type": "string" } }, -"type": "object" +"path": "v1/{+name}", +"response": { +"$ref": "UserListGlobalLicense" }, -"CartData": { -"description": "The cart data associated with the event.", -"id": "CartData", -"properties": { -"items": { -"description": "Optional. The list of items associated with the event.", -"items": { -"$ref": "Item" +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] }, -"type": "array" +"list": { +"description": "Lists all user list global licenses owned by the parent account. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses", +"httpMethod": "GET", +"id": "datamanager.accountTypes.accounts.userListGlobalLicenses.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"filter": { +"description": "Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`", +"location": "query", +"type": "string" }, -"merchantFeedLabel": { -"description": "Optional. The Merchant Center feed label associated with the feed of the items.", +"pageSize": { +"description": "Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. A page token, received from a previous `ListUserListGlobalLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.", +"location": "query", "type": "string" }, -"merchantFeedLanguageCode": { -"description": "Optional. The language code in ISO 639-1 associated with the Merchant Center feed of the items.where your items are uploaded.", +"parent": { +"description": "Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, "type": "string" +} }, -"merchantId": { -"description": "Optional. The Merchant Center ID associated with the items.", +"path": "v1/{+parent}/userListGlobalLicenses", +"response": { +"$ref": "ListUserListGlobalLicensesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +}, +"patch": { +"description": "Updates a user list global license. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses/{userListGlobalLicensesId}", +"httpMethod": "PATCH", +"id": "datamanager.accountTypes.accounts.userListGlobalLicenses.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The resource name of the user list global license.", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListGlobalLicenses/[^/]+$", +"required": true, "type": "string" }, -"transactionDiscount": { -"description": "Optional. The sum of all discounts associated with the transaction.", -"format": "double", -"type": "number" +"updateMask": { +"description": "Optional. The list of fields to update. The special character `*` is not supported and an `INVALID_UPDATE_MASK` error will be thrown if used.", +"format": "google-fieldmask", +"location": "query", +"type": "string" } }, -"type": "object" +"path": "v1/{+name}", +"request": { +"$ref": "UserListGlobalLicense" +}, +"response": { +"$ref": "UserListGlobalLicense" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +} +}, +"resources": { +"userListGlobalLicenseCustomerInfos": { +"methods": { +"list": { +"description": "Lists all customer info for a user list global license. This feature is only available to data partners.", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses/{userListGlobalLicensesId}/userListGlobalLicenseCustomerInfos", +"httpMethod": "GET", +"id": "datamanager.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"filter": { +"description": "Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`", +"location": "query", +"type": "string" +}, +"pageSize": { +"description": "Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. A page token, received from a previous `ListUserListDirectLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The global license whose customer info are being queried. Should be in the format `accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}`. To list all global license customer info under an account, replace the user list global license id with a '-' (for example, `accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-`)", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListGlobalLicenses/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/userListGlobalLicenseCustomerInfos", +"response": { +"$ref": "ListUserListGlobalLicenseCustomerInfosResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +} +} +} +} +}, +"userLists": { +"methods": { +"create": { +"description": "Creates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists", +"httpMethod": "POST", +"id": "datamanager.accountTypes.accounts.userLists.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The parent account where this user list will be created. Format: accountTypes/{account_type}/accounts/{account}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, +"type": "string" +}, +"validateOnly": { +"description": "Optional. If true, the request is validated but not executed.", +"location": "query", +"type": "boolean" +} +}, +"path": "v1/{+parent}/userLists", +"request": { +"$ref": "UserList" +}, +"response": { +"$ref": "UserList" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +}, +"delete": { +"description": "Deletes a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists/{userListsId}", +"httpMethod": "DELETE", +"id": "datamanager.accountTypes.accounts.userLists.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The name of the user list to delete. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userLists/[^/]+$", +"required": true, +"type": "string" +}, +"validateOnly": { +"description": "Optional. If true, the request is validated but not executed.", +"location": "query", +"type": "boolean" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "Empty" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +}, +"get": { +"description": "Gets a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists/{userListsId}", +"httpMethod": "GET", +"id": "datamanager.accountTypes.accounts.userLists.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the UserList to retrieve. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userLists/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "UserList" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +}, +"list": { +"description": "Lists UserLists. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists", +"httpMethod": "GET", +"id": "datamanager.accountTypes.accounts.userLists.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"filter": { +"description": "Optional. A [filter string](//google.aip.dev/160). All fields need to be on the left hand side of each condition (for example: `display_name = \"list 1\"`). Supported operations: - `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` - `:` (has) Supported fields: - `id` - `display_name` - `description` - `membership_status` - `integration_code` - `access_reason` - `ingested_user_list_info.upload_key_types`", +"location": "query", +"type": "string" +}, +"pageSize": { +"description": "Optional. The maximum number of user lists to return. The service may return fewer than this value. If unspecified, at most 50 user lists will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. A page token, received from a previous `ListUserLists` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLists` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The parent account which owns this collection of user lists. Format: accountTypes/{account_type}/accounts/{account}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/userLists", +"response": { +"$ref": "ListUserListsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +}, +"patch": { +"description": "Updates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", +"flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists/{userListsId}", +"httpMethod": "PATCH", +"id": "datamanager.accountTypes.accounts.userLists.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", +"location": "path", +"pattern": "^accountTypes/[^/]+/accounts/[^/]+/userLists/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Optional. The list of fields to update.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +}, +"validateOnly": { +"description": "Optional. If true, the request is validated but not executed.", +"location": "query", +"type": "boolean" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "UserList" +}, +"response": { +"$ref": "UserList" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +} +} +} +} +} +} +}, +"audienceMembers": { +"methods": { +"ingest": { +"description": "Uploads a list of AudienceMember resources to the provided Destination.", +"flatPath": "v1/audienceMembers:ingest", +"httpMethod": "POST", +"id": "datamanager.audienceMembers.ingest", +"parameterOrder": [], +"parameters": {}, +"path": "v1/audienceMembers:ingest", +"request": { +"$ref": "IngestAudienceMembersRequest" +}, +"response": { +"$ref": "IngestAudienceMembersResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +}, +"remove": { +"description": "Removes a list of AudienceMember resources from the provided Destination.", +"flatPath": "v1/audienceMembers:remove", +"httpMethod": "POST", +"id": "datamanager.audienceMembers.remove", +"parameterOrder": [], +"parameters": {}, +"path": "v1/audienceMembers:remove", +"request": { +"$ref": "RemoveAudienceMembersRequest" +}, +"response": { +"$ref": "RemoveAudienceMembersResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +} +} +}, +"events": { +"methods": { +"ingest": { +"description": "Uploads a list of Event resources from the provided Destination.", +"flatPath": "v1/events:ingest", +"httpMethod": "POST", +"id": "datamanager.events.ingest", +"parameterOrder": [], +"parameters": {}, +"path": "v1/events:ingest", +"request": { +"$ref": "IngestEventsRequest" +}, +"response": { +"$ref": "IngestEventsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +} +} +}, +"requestStatus": { +"methods": { +"retrieve": { +"description": "Gets the status of a request given request id.", +"flatPath": "v1/requestStatus:retrieve", +"httpMethod": "GET", +"id": "datamanager.requestStatus.retrieve", +"parameterOrder": [], +"parameters": { +"requestId": { +"description": "Required. Required. The request ID of the Data Manager API request.", +"location": "query", +"type": "string" +} +}, +"path": "v1/requestStatus:retrieve", +"response": { +"$ref": "RetrieveRequestStatusResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/datamanager" +] +} +} +} +}, +"revision": "20260217", +"rootUrl": "https://datamanager.googleapis.com/", +"schemas": { +"AdIdentifiers": { +"description": "Identifiers and other information used to match the conversion event with other online activity (such as ad clicks).", +"id": "AdIdentifiers", +"properties": { +"gbraid": { +"description": "Optional. The click identifier for clicks associated with app events and originating from iOS devices starting with iOS14.", +"type": "string" +}, +"gclid": { +"description": "Optional. The Google click ID (gclid) associated with this event.", +"type": "string" +}, +"landingPageDeviceInfo": { +"$ref": "DeviceInfo", +"description": "Optional. Information gathered about the device being used (if any) at the time of landing onto the advertiser\u2019s site after interacting with the ad." +}, +"sessionAttributes": { +"description": "Optional. Session attributes for event attribution and modeling.", +"type": "string" +}, +"wbraid": { +"description": "Optional. The click identifier for clicks associated with web events and originating from iOS devices starting with iOS14.", +"type": "string" +} +}, +"type": "object" +}, +"AddressInfo": { +"description": "Address information for the user.", +"id": "AddressInfo", +"properties": { +"familyName": { +"description": "Required. Family (last) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256.", +"type": "string" +}, +"givenName": { +"description": "Required. Given (first) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256.", +"type": "string" +}, +"postalCode": { +"description": "Required. The postal code of the user's address.", +"type": "string" +}, +"regionCode": { +"description": "Required. The 2-letter region code in ISO-3166-1 alpha-2 of the user's address.", +"type": "string" +} +}, +"type": "object" +}, +"AudienceMember": { +"description": "The audience member to be operated on.", +"id": "AudienceMember", +"properties": { +"consent": { +"$ref": "Consent", +"description": "Optional. The consent setting for the user." +}, +"destinationReferences": { +"description": "Optional. Defines which Destination to send the audience member to.", +"items": { +"type": "string" +}, +"type": "array" +}, +"mobileData": { +"$ref": "MobileData", +"description": "Data identifying the user's mobile devices." +}, +"pairData": { +"$ref": "PairData", +"description": "[Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908). This feature is only available to data partners." +}, +"ppidData": { +"$ref": "PpidData", +"description": "Data related to publisher provided identifiers. This feature is only available to data partners." +}, +"userData": { +"$ref": "UserData", +"description": "User-provided data that identifies the user." +}, +"userIdData": { +"$ref": "UserIdData", +"description": "Data related to unique identifiers for a user, as defined by the advertiser." +} +}, +"type": "object" +}, +"AwsWrappedKeyInfo": { +"description": "A data encryption key wrapped by an AWS KMS key.", +"id": "AwsWrappedKeyInfo", +"properties": { +"encryptedDek": { +"description": "Required. The base64 encoded encrypted data encryption key.", +"type": "string" +}, +"kekUri": { +"description": "Required. The URI of the AWS KMS key used to decrypt the DEK. Should be in the format of `arn:{partition}:kms:{region}:{account_id}:key/{key_id}` or `aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}`", +"type": "string" +}, +"keyType": { +"description": "Required. The type of algorithm used to encrypt the data.", +"enum": [ +"KEY_TYPE_UNSPECIFIED", +"XCHACHA20_POLY1305" +], +"enumDescriptions": [ +"Unspecified key type. Should never be used.", +"Algorithm XChaCha20-Poly1305" +], +"type": "string" +}, +"roleArn": { +"description": "Required. The Amazon Resource Name of the IAM Role to assume for KMS decryption access. Should be in the format of `arn:{partition}:iam::{account_id}:role/{role_name}`", +"type": "string" +} +}, +"type": "object" +}, +"Baseline": { +"description": "Baseline criteria against which insights are compared.", +"id": "Baseline", +"properties": { +"baselineLocation": { +"$ref": "Location", +"description": "The baseline location of the request. Baseline location is an OR-list of the requested regions." +}, +"locationAutoDetectionEnabled": { +"description": "If set to true, the service will try to automatically detect the baseline location for insights.", +"type": "boolean" +} +}, +"type": "object" +}, +"CartData": { +"description": "The cart data associated with the event.", +"id": "CartData", +"properties": { +"items": { +"description": "Optional. The list of items associated with the event.", +"items": { +"$ref": "Item" +}, +"type": "array" +}, +"merchantFeedLabel": { +"description": "Optional. The Merchant Center feed label associated with the feed of the items.", +"type": "string" +}, +"merchantFeedLanguageCode": { +"description": "Optional. The language code in ISO 639-1 associated with the Merchant Center feed of the items.where your items are uploaded.", +"type": "string" +}, +"merchantId": { +"description": "Optional. The Merchant Center ID associated with the items.", +"type": "string" +}, +"transactionDiscount": { +"description": "Optional. The sum of all discounts associated with the transaction.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"Consent": { +"description": "[Digital Markets Act (DMA)](//digital-markets-act.ec.europa.eu/index_en) consent settings for the user.", +"id": "Consent", +"properties": { +"adPersonalization": { +"description": "Optional. Represents if the user consents to ad personalization.", +"enum": [ +"CONSENT_STATUS_UNSPECIFIED", +"CONSENT_GRANTED", +"CONSENT_DENIED" +], +"enumDescriptions": [ +"Not specified.", +"Granted.", +"Denied." +], +"type": "string" +}, +"adUserData": { +"description": "Optional. Represents if the user consents to ad user data.", +"enum": [ +"CONSENT_STATUS_UNSPECIFIED", +"CONSENT_GRANTED", +"CONSENT_DENIED" +], +"enumDescriptions": [ +"Not specified.", +"Granted.", +"Denied." +], +"type": "string" +} +}, +"type": "object" +}, +"ContactIdInfo": { +"description": "Additional information when `CONTACT_ID` is one of the `upload_key_types`.", +"id": "ContactIdInfo", +"properties": { +"dataSourceType": { +"description": "Optional. Immutable. Source of the upload data", +"enum": [ +"DATA_SOURCE_TYPE_UNSPECIFIED", +"DATA_SOURCE_TYPE_FIRST_PARTY", +"DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU", +"DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE", +"DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" +], +"enumDescriptions": [ +"Not specified.", +"The uploaded data is first-party data.", +"The uploaded data is from a third-party credit bureau.", +"The uploaded data is from a third-party voter file.", +"The uploaded data is third party partner data." +], +"type": "string" +}, +"matchRatePercentage": { +"description": "Output only. Match rate for customer match user lists.", +"format": "int32", +"readOnly": true, +"type": "integer" +} +}, +"type": "object" +}, +"CustomVariable": { +"description": "Custom variable for ads conversions.", +"id": "CustomVariable", +"properties": { +"destinationReferences": { +"description": "Optional. Reference string used to determine which of the Event.destination_references the custom variable should be sent to. If empty, the Event.destination_references will be used.", +"items": { +"type": "string" +}, +"type": "array" +}, +"value": { +"description": "Optional. The value to store for the custom variable.", +"type": "string" +}, +"variable": { +"description": "Optional. The name of the custom variable to set. If the variable is not found for the given destination, it will be ignored.", +"type": "string" +} +}, +"type": "object" +}, +"Destination": { +"description": "The Google product you're sending data to. For example, a Google Ads account.", +"id": "Destination", +"properties": { +"linkedAccount": { +"$ref": "ProductAccount", +"description": "Optional. An account that the calling user's `login_account` has access to, through an established account link. For example, a data partner's `login_account` might have access to a client's `linked_account`. The partner might use this field to send data from the `linked_account` to another `operating_account`." +}, +"loginAccount": { +"$ref": "ProductAccount", +"description": "Optional. The account used to make this API call. To add or remove data from the `operating_account`, this `login_account` must have write access to the `operating_account`. For example, a manager account of the `operating_account`, or an account with an established link to the `operating_account`." +}, +"operatingAccount": { +"$ref": "ProductAccount", +"description": "Required. The account to send the data to or remove the data from." +}, +"productDestinationId": { +"description": "Required. The object within the product account to ingest into. For example, a Google Ads audience ID, a Display & Video 360 audience ID or a Google Ads conversion action ID.", +"type": "string" +}, +"reference": { +"description": "Optional. ID for this `Destination` resource, unique within the request. Use to reference this `Destination` in the IngestEventsRequest and IngestAudienceMembersRequest.", +"type": "string" +} +}, +"type": "object" +}, +"DeviceInfo": { +"description": "Information about the device being used (if any) when the event happened.", +"id": "DeviceInfo", +"properties": { +"ipAddress": { +"description": "Optional. The IP address of the device for the given context. **Note:** Google Ads does not support IP address matching for end users in the European Economic Area (EEA), United Kingdom (UK), or Switzerland (CH). Add logic to conditionally exclude sharing IP addresses from users from these regions and ensure that you provide users with clear and comprehensive information about the data you collect on your sites, apps, and other properties and get consent where required by law or any applicable Google policies. See the [About offline conversion imports](https://support.google.com/google-ads/answer/2998031) page for more details.", +"type": "string" +}, +"userAgent": { +"description": "Optional. The user-agent string of the device for the given context.", +"type": "string" +} +}, +"type": "object" +}, +"Empty": { +"description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", +"id": "Empty", +"properties": {}, +"type": "object" +}, +"EncryptionInfo": { +"description": "Encryption information for the data being ingested.", +"id": "EncryptionInfo", +"properties": { +"awsWrappedKeyInfo": { +"$ref": "AwsWrappedKeyInfo", +"description": "Amazon Web Services wrapped key information." +}, +"gcpWrappedKeyInfo": { +"$ref": "GcpWrappedKeyInfo", +"description": "Google Cloud Platform wrapped key information." +} +}, +"type": "object" +}, +"ErrorCount": { +"description": "The error count for a given error reason.", +"id": "ErrorCount", +"properties": { +"reason": { +"description": "The error reason of the failed records.", +"enum": [ +"PROCESSING_ERROR_REASON_UNSPECIFIED", +"PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE", +"PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED", +"PROCESSING_ERROR_REASON_EVENT_TOO_OLD", +"PROCESSING_ERROR_REASON_DENIED_CONSENT", +"PROCESSING_ERROR_REASON_NO_CONSENT", +"PROCESSING_ERROR_REASON_UNKNOWN_CONSENT", +"PROCESSING_ERROR_REASON_DUPLICATE_GCLID", +"PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID", +"PROCESSING_ERROR_REASON_INVALID_GBRAID", +"PROCESSING_ERROR_REASON_INVALID_GCLID", +"PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID", +"PROCESSING_ERROR_REASON_INVALID_WBRAID", +"PROCESSING_ERROR_REASON_INTERNAL_ERROR", +"PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED", +"PROCESSING_ERROR_REASON_INVALID_EVENT", +"PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS", +"PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS", +"PROCESSING_ERROR_REASON_INVALID_FORMAT", +"PROCESSING_ERROR_REASON_DECRYPTION_ERROR", +"PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR", +"PROCESSING_ERROR_REASON_INVALID_WIP", +"PROCESSING_ERROR_REASON_INVALID_KEK", +"PROCESSING_ERROR_REASON_WIP_AUTH_FAILED", +"PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED", +"PROCESSING_ERROR_REASON_AWS_AUTH_FAILED", +"PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR", +"PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER" +], +"enumDescriptions": [ +"The processing error reason is unknown.", +"The custom variable is invalid.", +"The status of the custom variable is not enabled.", +"The conversion is older than max supported age.", +"The ad user data is denied, either by the user or in the advertiser default settings.", +"Advertiser did not give 3P consent for the Ads core platform services.", +"The overall consent (determined from row level consent, request level consent, and account settings) could not be determined for this user", +"A conversion with the same GCLID and conversion time already exists in the system.", +"A conversion with the same order id and conversion action combination was already uploaded.", +"The gbraid could not be decoded.", +"The google click ID could not be decoded.", +"Merchant id contains non-digit characters.", +"The wbraid could not be decoded.", +"Internal error.", +"Enhanced conversions terms are not signed in the destination account.", +"The event is invalid.", +"The matched transactions are less than the minimum threshold.", +"The transactions are less than the minimum threshold.", +"The event has format error.", +"The event has a decryption error.", +"The DEK failed to be decrypted.", +"The WIP is formatted incorrectly or the WIP does not exist.", +"The KEK cannot decrypt data because it is the wrong KEK, or it does not exist.", +"The WIP could not be used because it was rejected by its attestation condition.", +"The system did not have the permissions needed to access the KEK.", +"The system failed to authenticate with AWS.", +"Failed to decrypt the UserIdentifier data using the DEK.", +"The user attempted to ingest events with an ad identifier that isn't from the operating account's ads." +], +"type": "string" +}, +"recordCount": { +"description": "The count of records that failed to upload for a given reason.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"ErrorInfo": { +"description": "Error counts for each type of error.", +"id": "ErrorInfo", +"properties": { +"errorCounts": { +"description": "A list of errors and counts per error reason. May not be populated in all cases.", +"items": { +"$ref": "ErrorCount" +}, +"type": "array" +} +}, +"type": "object" +}, +"Event": { +"description": "An event representing a user interaction with an advertiser's website or app.", +"id": "Event", +"properties": { +"adIdentifiers": { +"$ref": "AdIdentifiers", +"description": "Optional. Identifiers and other information used to match the conversion event with other online activity (such as ad clicks)." +}, +"additionalEventParameters": { +"description": "Optional. A bucket of any [event parameters](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events) to be included within the event that were not already specified using other structured fields.", +"items": { +"$ref": "EventParameter" +}, +"type": "array" +}, +"cartData": { +"$ref": "CartData", +"description": "Optional. Information about the transaction and items associated with the event." +}, +"clientId": { +"description": "Optional. A unique identifier for the user instance of a web client for this GA4 web stream.", +"type": "string" +}, +"consent": { +"$ref": "Consent", +"description": "Optional. Information about whether the associated user has provided different types of consent." +}, +"conversionValue": { +"description": "Optional. The conversion value associated with the event, for value-based conversions.", +"format": "double", +"type": "number" +}, +"currency": { +"description": "Optional. The currency code associated with all monetary values within this event.", +"type": "string" +}, +"customVariables": { +"description": "Optional. Additional key/value pair information to send to the conversion containers (conversion action or FL activity).", +"items": { +"$ref": "CustomVariable" +}, +"type": "array" +}, +"destinationReferences": { +"description": "Optional. Reference string used to determine the destination. If empty, the event will be sent to all destinations in the request.", +"items": { +"type": "string" +}, +"type": "array" +}, +"eventDeviceInfo": { +"$ref": "DeviceInfo", +"description": "Optional. Information gathered about the device being used (if any) when the event happened." +}, +"eventName": { +"description": "Optional. The name of the event. Required for GA4 events.", +"type": "string" +}, +"eventSource": { +"description": "Optional. Signal for where the event happened (web, app, in-store, etc.).", +"enum": [ +"EVENT_SOURCE_UNSPECIFIED", +"WEB", +"APP", +"IN_STORE", +"PHONE", +"OTHER" +], +"enumDescriptions": [ +"Unspecified EventSource. Should never be used.", +"The event was generated from a web browser.", +"The event was generated from an app.", +"The event was generated from an in-store transaction.", +"The event was generated from a phone call.", +"The event was generated from other sources." +], +"type": "string" +}, +"eventTimestamp": { +"description": "Required. The time the event occurred.", +"format": "google-datetime", +"type": "string" +}, +"experimentalFields": { +"description": "Optional. A list of key/value pairs for experimental fields that may eventually be promoted to be part of the API.", +"items": { +"$ref": "ExperimentalField" +}, +"type": "array" +}, +"lastUpdatedTimestamp": { +"description": "Optional. The last time the event was updated.", +"format": "google-datetime", +"type": "string" +}, +"transactionId": { +"description": "Optional. The unique identifier for this event. Required for conversions using multiple data sources.", +"type": "string" +}, +"userData": { +"$ref": "UserData", +"description": "Optional. Pieces of user provided data, representing the user the event is associated with." +}, +"userId": { +"description": "Optional. A unique identifier for a user, as defined by the advertiser.", +"type": "string" +}, +"userProperties": { +"$ref": "UserProperties", +"description": "Optional. Advertiser-assessed information about the user at the time that the event happened." +} +}, +"type": "object" +}, +"EventParameter": { +"description": "Event parameter for GA4 events.", +"id": "EventParameter", +"properties": { +"parameterName": { +"description": "Required. The name of the parameter to use.", +"type": "string" +}, +"value": { +"description": "Required. The string representation of the value of the parameter to set.", +"type": "string" +} +}, +"type": "object" +}, +"ExperimentalField": { +"description": "Experimental field representing unofficial fields.", +"id": "ExperimentalField", +"properties": { +"field": { +"description": "Optional. The name of the field to use.", +"type": "string" +}, +"value": { +"description": "Optional. The value the field to set.", +"type": "string" +} +}, +"type": "object" +}, +"GcpWrappedKeyInfo": { +"description": "Information about the Google Cloud Platform wrapped key.", +"id": "GcpWrappedKeyInfo", +"properties": { +"encryptedDek": { +"description": "Required. The base64 encoded encrypted data encryption key.", +"type": "string" +}, +"kekUri": { +"description": "Required. Google Cloud Platform [Cloud Key Management Service resource ID](//cloud.google.com/kms/docs/getting-resource-ids). Should be in the format of `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}` or `gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}`", +"type": "string" +}, +"keyType": { +"description": "Required. The type of algorithm used to encrypt the data.", +"enum": [ +"KEY_TYPE_UNSPECIFIED", +"XCHACHA20_POLY1305" +], +"enumDescriptions": [ +"Unspecified key type. Should never be used.", +"Algorithm XChaCha20-Poly1305" +], +"type": "string" +}, +"wipProvider": { +"description": "Required. The [Workload Identity](//cloud.google.com/iam/docs/workload-identity-federation) pool provider required to use KEK.", +"type": "string" +} +}, +"type": "object" +}, +"IngestAudienceMembersRequest": { +"description": "Request to upload audience members to the provided destinations. Returns an IngestAudienceMembersResponse.", +"id": "IngestAudienceMembersRequest", +"properties": { +"audienceMembers": { +"description": "Required. The list of users to send to the specified destinations. At most 10000 AudienceMember resources can be sent in a single request.", +"items": { +"$ref": "AudienceMember" +}, +"type": "array" +}, +"consent": { +"$ref": "Consent", +"description": "Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each AudienceMember." +}, +"destinations": { +"description": "Required. The list of destinations to send the audience members to.", +"items": { +"$ref": "Destination" +}, +"type": "array" +}, +"encoding": { +"description": "Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non `UserData` uploads, this field is ignored.", +"enum": [ +"ENCODING_UNSPECIFIED", +"HEX", +"BASE64" +], +"enumDescriptions": [ +"Unspecified Encoding type. Should never be used.", +"Hex encoding.", +"Base 64 encoding." +], +"type": "string" +}, +"encryptionInfo": { +"$ref": "EncryptionInfo", +"description": "Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored." +}, +"termsOfService": { +"$ref": "TermsOfService", +"description": "Optional. The terms of service that the user has accepted/rejected." +}, +"validateOnly": { +"description": "Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results.", +"type": "boolean" +} +}, +"type": "object" +}, +"IngestAudienceMembersResponse": { +"description": "Response from the IngestAudienceMembersRequest.", +"id": "IngestAudienceMembersResponse", +"properties": { +"requestId": { +"description": "The auto-generated ID of the request.", +"type": "string" +} +}, +"type": "object" +}, +"IngestAudienceMembersStatus": { +"description": "The status of the ingest audience members request.", +"id": "IngestAudienceMembersStatus", +"properties": { +"mobileDataIngestionStatus": { +"$ref": "IngestMobileDataStatus", +"description": "The status of the mobile data ingestion to the destination." +}, +"pairDataIngestionStatus": { +"$ref": "IngestPairDataStatus", +"description": "The status of the pair data ingestion to the destination." +}, +"ppidDataIngestionStatus": { +"$ref": "IngestPpidDataStatus", +"description": "The status of the ppid data ingestion to the destination." +}, +"userDataIngestionStatus": { +"$ref": "IngestUserDataStatus", +"description": "The status of the user data ingestion to the destination." +}, +"userIdDataIngestionStatus": { +"$ref": "IngestUserIdDataStatus", +"description": "The status of the user id data ingestion to the destination." +} +}, +"type": "object" +}, +"IngestEventsRequest": { +"description": "Request to upload audience members to the provided destinations. Returns an IngestEventsResponse.", +"id": "IngestEventsRequest", +"properties": { +"consent": { +"$ref": "Consent", +"description": "Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each Event." }, -"Consent": { -"description": "[Digital Markets Act (DMA)](//digital-markets-act.ec.europa.eu/index_en) consent settings for the user.", -"id": "Consent", +"destinations": { +"description": "Required. The list of destinations to send the events to.", +"items": { +"$ref": "Destination" +}, +"type": "array" +}, +"encoding": { +"description": "Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non `UserData` uploads, this field is ignored.", +"enum": [ +"ENCODING_UNSPECIFIED", +"HEX", +"BASE64" +], +"enumDescriptions": [ +"Unspecified Encoding type. Should never be used.", +"Hex encoding.", +"Base 64 encoding." +], +"type": "string" +}, +"encryptionInfo": { +"$ref": "EncryptionInfo", +"description": "Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored." +}, +"events": { +"description": "Required. The list of events to send to the specified destinations. At most 2000 Event resources can be sent in a single request.", +"items": { +"$ref": "Event" +}, +"type": "array" +}, +"validateOnly": { +"description": "Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results.", +"type": "boolean" +} +}, +"type": "object" +}, +"IngestEventsResponse": { +"description": "Response from the IngestEventsRequest.", +"id": "IngestEventsResponse", "properties": { -"adPersonalization": { -"description": "Optional. Represents if the user consents to ad personalization.", +"requestId": { +"description": "The auto-generated ID of the request.", +"type": "string" +} +}, +"type": "object" +}, +"IngestEventsStatus": { +"description": "The status of the events ingestion to the destination.", +"id": "IngestEventsStatus", +"properties": { +"recordCount": { +"description": "The total count of events sent in the upload request. Includes all events in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"IngestMobileDataStatus": { +"description": "The status of the mobile data ingestion to the destination containing stats related to the ingestion.", +"id": "IngestMobileDataStatus", +"properties": { +"mobileIdCount": { +"description": "The total count of mobile ids sent in the upload request for the destination. Includes all mobile ids in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +}, +"recordCount": { +"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"IngestPairDataStatus": { +"description": "The status of the pair data ingestion to the destination containing stats related to the ingestion.", +"id": "IngestPairDataStatus", +"properties": { +"pairIdCount": { +"description": "The total count of pair ids sent in the upload request for the destination. Includes all pair ids in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +}, +"recordCount": { +"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"IngestPpidDataStatus": { +"description": "The status of the ppid data ingestion to the destination containing stats related to the ingestion.", +"id": "IngestPpidDataStatus", +"properties": { +"ppidCount": { +"description": "The total count of ppids sent in the upload request for the destination. Includes all ppids in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +}, +"recordCount": { +"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"IngestUserDataStatus": { +"description": "The status of the user data ingestion to the destination containing stats related to the ingestion.", +"id": "IngestUserDataStatus", +"properties": { +"recordCount": { +"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +}, +"uploadMatchRateRange": { +"description": "The match rate range of the upload.", "enum": [ -"CONSENT_STATUS_UNSPECIFIED", -"CONSENT_GRANTED", -"CONSENT_DENIED" +"MATCH_RATE_RANGE_UNKNOWN", +"MATCH_RATE_RANGE_NOT_ELIGIBLE", +"MATCH_RATE_RANGE_LESS_THAN_20", +"MATCH_RATE_RANGE_20_TO_30", +"MATCH_RATE_RANGE_31_TO_40", +"MATCH_RATE_RANGE_41_TO_50", +"MATCH_RATE_RANGE_51_TO_60", +"MATCH_RATE_RANGE_61_TO_70", +"MATCH_RATE_RANGE_71_TO_80", +"MATCH_RATE_RANGE_81_TO_90", +"MATCH_RATE_RANGE_91_TO_100" ], "enumDescriptions": [ -"Not specified.", -"Granted.", -"Denied." +"The match rate range is unknown.", +"The match rate range is not eligible.", +"The match rate range is less than 20% (in the interval `[0, 20)`).", +"The match rate range is between 20% and 30% (in the interval `[20, 31)`).", +"The match rate range is between 31% and 40% (in the interval `[31, 41)`).", +"The match rate range is between 41% and 50% (in the interval `[41, 51)`).", +"The match rate range is between 51% and 60% (in the interval `[51, 61)`.", +"The match rate range is between 61% and 70% (in the interval `[61, 71)`).", +"The match rate range is between 71% and 80% (in the interval `[71, 81)`).", +"The match rate range is between 81% and 90% (in the interval `[81, 91)`).", +"The match rate range is between 91% and 100% (in the interval `[91, 100]`)." ], "type": "string" }, -"adUserData": { -"description": "Optional. Represents if the user consents to ad user data.", +"userIdentifierCount": { +"description": "The total count of user identifiers sent in the upload request for the destination. Includes all user identifiers in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"IngestUserIdDataStatus": { +"description": "The status of the user id data ingestion to the destination containing stats related to the ingestion.", +"id": "IngestUserIdDataStatus", +"properties": { +"recordCount": { +"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +}, +"userIdCount": { +"description": "The total count of user ids sent in the upload request for the destination. Includes all user ids in the request, regardless of whether they were successfully ingested or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"IngestedUserListInfo": { +"description": "Represents a user list that is populated by user provided data.", +"id": "IngestedUserListInfo", +"properties": { +"contactIdInfo": { +"$ref": "ContactIdInfo", +"description": "Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`." +}, +"mobileIdInfo": { +"$ref": "MobileIdInfo", +"description": "Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`." +}, +"pairIdInfo": { +"$ref": "PairIdInfo", +"description": "Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners." +}, +"partnerAudienceInfo": { +"$ref": "PartnerAudienceInfo", +"description": "Optional. Additional information for partner audiences. This feature is only available to data partners." +}, +"pseudonymousIdInfo": { +"$ref": "PseudonymousIdInfo", +"description": "Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`." +}, +"uploadKeyTypes": { +"description": "Required. Immutable. Upload key types of this user list.", +"items": { "enum": [ -"CONSENT_STATUS_UNSPECIFIED", -"CONSENT_GRANTED", -"CONSENT_DENIED" +"UPLOAD_KEY_TYPE_UNSPECIFIED", +"CONTACT_ID", +"MOBILE_ID", +"USER_ID", +"PAIR_ID", +"PSEUDONYMOUS_ID" ], "enumDescriptions": [ "Not specified.", -"Granted.", -"Denied." +"Customer info such as email address, phone number or physical address.", +"Mobile advertising ids.", +"Third party provided user ids.", +"Publisher advertiser identity reconciliation ids.", +"Data Management Platform IDs: - Google User ID - Partner Provided ID - Publisher Provided ID - iOS IDFA - Android advertising ID - Roku ID - Amazon Fire TV ID - Xbox or Microsoft ID" ], "type": "string" +}, +"type": "array" +}, +"userIdInfo": { +"$ref": "UserIdInfo", +"description": "Optional. Additional information when `USER_ID` is one of the `upload_key_types`." } }, "type": "object" }, -"CustomVariable": { -"description": "Custom variable for ads conversions.", -"id": "CustomVariable", +"Item": { +"description": "Represents an item in the cart associated with the event.", +"id": "Item", "properties": { -"destinationReferences": { -"description": "Optional. Reference string used to determine which of the Event.destination_references the custom variable should be sent to. If empty, the Event.destination_references will be used.", +"additionalItemParameters": { +"description": "Optional. A bucket of any [event parameters related to an item](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events) to be included within the event that were not already specified using other structured fields.", "items": { -"type": "string" +"$ref": "ItemParameter" }, "type": "array" }, -"value": { -"description": "Optional. The value to store for the custom variable.", +"itemId": { +"description": "Optional. A unique identifier to reference the item.", "type": "string" }, -"variable": { -"description": "Optional. The name of the custom variable to set. If the variable is not found for the given destination, it will be ignored.", +"merchantProductId": { +"description": "Optional. The product ID within the Merchant Center account.", +"type": "string" +}, +"quantity": { +"description": "Optional. The number of this item associated with the event.", +"format": "int64", "type": "string" +}, +"unitPrice": { +"description": "Optional. The unit price excluding tax, shipping, and any transaction level discounts.", +"format": "double", +"type": "number" } }, "type": "object" }, -"Destination": { -"description": "The Google product you're sending data to. For example, a Google Ads account.", -"id": "Destination", +"ItemParameter": { +"description": "A bucket of any [event parameters related to an item](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events) to be included within the event that were not already specified using other structured fields.", +"id": "ItemParameter", "properties": { -"linkedAccount": { -"$ref": "ProductAccount", -"description": "Optional. An account that the calling user's `login_account` has access to, through an established account link. For example, a data partner's `login_account` might have access to a client's `linked_account`. The partner might use this field to send data from the `linked_account` to another `operating_account`." +"parameterName": { +"description": "Required. The name of the parameter to use.", +"type": "string" }, -"loginAccount": { -"$ref": "ProductAccount", -"description": "Optional. The account used to make this API call. To add or remove data from the `operating_account`, this `login_account` must have write access to the `operating_account`. For example, a manager account of the `operating_account`, or an account with an established link to the `operating_account`." +"value": { +"description": "Required. The string representation of the value of the parameter to set.", +"type": "string" +} }, -"operatingAccount": { -"$ref": "ProductAccount", -"description": "Required. The account to send the data to or remove the data from." +"type": "object" }, -"productDestinationId": { -"description": "Required. The object within the product account to ingest into. For example, a Google Ads audience ID, a Display & Video 360 audience ID or a Google Ads conversion action ID.", +"ListUserListDirectLicensesResponse": { +"description": "Response from the ListUserListDirectLicensesRequest.", +"id": "ListUserListDirectLicensesResponse", +"properties": { +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, -"reference": { -"description": "Optional. ID for this `Destination` resource, unique within the request. Use to reference this `Destination` in the IngestEventsRequest and IngestAudienceMembersRequest.", -"type": "string" +"userListDirectLicenses": { +"description": "The licenses for the given user list in the request.", +"items": { +"$ref": "UserListDirectLicense" +}, +"type": "array" } }, "type": "object" }, -"DeviceInfo": { -"description": "Information about the device being used (if any) when the event happened.", -"id": "DeviceInfo", +"ListUserListGlobalLicenseCustomerInfosResponse": { +"description": "Response from the ListUserListGlobalLicensesCustomerInfoRequest.", +"id": "ListUserListGlobalLicenseCustomerInfosResponse", "properties": { -"ipAddress": { -"description": "Optional. The IP address of the device for the given context. **Note:** Google Ads does not support IP address matching for end users in the European Economic Area (EEA), United Kingdom (UK), or Switzerland (CH). Add logic to conditionally exclude sharing IP addresses from users from these regions and ensure that you provide users with clear and comprehensive information about the data you collect on your sites, apps, and other properties and get consent where required by law or any applicable Google policies. See the [About offline conversion imports](https://support.google.com/google-ads/answer/2998031) page for more details.", +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, -"userAgent": { -"description": "Optional. The user-agent string of the device for the given context.", -"type": "string" +"userListGlobalLicenseCustomerInfos": { +"description": "The customer information for the given license in the request.", +"items": { +"$ref": "UserListGlobalLicenseCustomerInfo" +}, +"type": "array" } }, "type": "object" }, -"EncryptionInfo": { -"description": "Encryption information for the data being ingested.", -"id": "EncryptionInfo", +"ListUserListGlobalLicensesResponse": { +"description": "Response from the ListUserListGlobalLicensesRequest.", +"id": "ListUserListGlobalLicensesResponse", "properties": { -"awsWrappedKeyInfo": { -"$ref": "AwsWrappedKeyInfo", -"description": "Amazon Web Services wrapped key information." +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", +"type": "string" }, -"gcpWrappedKeyInfo": { -"$ref": "GcpWrappedKeyInfo", -"description": "Google Cloud Platform wrapped key information." +"userListGlobalLicenses": { +"description": "The licenses for the given user list in the request.", +"items": { +"$ref": "UserListGlobalLicense" +}, +"type": "array" } }, "type": "object" }, -"ErrorCount": { -"description": "The error count for a given error reason.", -"id": "ErrorCount", +"ListUserListsResponse": { +"description": "Response message for ListUserLists.", +"id": "ListUserListsResponse", "properties": { -"reason": { -"description": "The error reason of the failed records.", -"enum": [ -"PROCESSING_ERROR_REASON_UNSPECIFIED", -"PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE", -"PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED", -"PROCESSING_ERROR_REASON_EVENT_TOO_OLD", -"PROCESSING_ERROR_REASON_DENIED_CONSENT", -"PROCESSING_ERROR_REASON_NO_CONSENT", -"PROCESSING_ERROR_REASON_UNKNOWN_CONSENT", -"PROCESSING_ERROR_REASON_DUPLICATE_GCLID", -"PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID", -"PROCESSING_ERROR_REASON_INVALID_GBRAID", -"PROCESSING_ERROR_REASON_INVALID_GCLID", -"PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID", -"PROCESSING_ERROR_REASON_INVALID_WBRAID", -"PROCESSING_ERROR_REASON_INTERNAL_ERROR", -"PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED", -"PROCESSING_ERROR_REASON_INVALID_EVENT", -"PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS", -"PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS", -"PROCESSING_ERROR_REASON_INVALID_FORMAT", -"PROCESSING_ERROR_REASON_DECRYPTION_ERROR", -"PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR", -"PROCESSING_ERROR_REASON_INVALID_WIP", -"PROCESSING_ERROR_REASON_INVALID_KEK", -"PROCESSING_ERROR_REASON_WIP_AUTH_FAILED", -"PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED", -"PROCESSING_ERROR_REASON_AWS_AUTH_FAILED", -"PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR", -"PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER" -], -"enumDescriptions": [ -"The processing error reason is unknown.", -"The custom variable is invalid.", -"The status of the custom variable is not enabled.", -"The conversion is older than max supported age.", -"The ad user data is denied, either by the user or in the advertiser default settings.", -"Advertiser did not give 3P consent for the Ads core platform services.", -"The overall consent (determined from row level consent, request level consent, and account settings) could not be determined for this user", -"A conversion with the same GCLID and conversion time already exists in the system.", -"A conversion with the same order id and conversion action combination was already uploaded.", -"The gbraid could not be decoded.", -"The google click ID could not be decoded.", -"Merchant id contains non-digit characters.", -"The wbraid could not be decoded.", -"Internal error.", -"Enhanced conversions terms are not signed in the destination account.", -"The event is invalid.", -"The matched transactions are less than the minimum threshold.", -"The transactions are less than the minimum threshold.", -"The event has format error.", -"The event has a decryption error.", -"The DEK failed to be decrypted.", -"The WIP is formatted incorrectly or the WIP does not exist.", -"The KEK cannot decrypt data because it is the wrong KEK, or it does not exist.", -"The WIP could not be used because it was rejected by its attestation condition.", -"The system did not have the permissions needed to access the KEK.", -"The system failed to authenticate with AWS.", -"Failed to decrypt the UserIdentifier data using the DEK.", -"The user attempted to ingest events with an ad identifier that isn't from the operating account's ads." -], +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, -"recordCount": { -"description": "The count of records that failed to upload for a given reason.", -"format": "int64", -"type": "string" +"userLists": { +"description": "The user lists from the specified account.", +"items": { +"$ref": "UserList" +}, +"type": "array" } }, "type": "object" }, -"ErrorInfo": { -"description": "Error counts for each type of error.", -"id": "ErrorInfo", +"Location": { +"description": "The baseline location of the request. Baseline location is on OR-list of ISO 3166-1 alpha-2 region codes of the requested regions.", +"id": "Location", "properties": { -"errorCounts": { -"description": "A list of errors and counts per error reason. May not be populated in all cases.", +"regionCodes": { +"description": "List of ISO 3166-1 alpha-2 region codes.", "items": { -"$ref": "ErrorCount" +"type": "string" }, "type": "array" } }, "type": "object" }, -"Event": { -"description": "An event representing a user interaction with an advertiser's website or app.", -"id": "Event", +"MarketingDataInsight": { +"description": "Insights for marketing data. This feature is only available to data partners.", +"id": "MarketingDataInsight", "properties": { -"adIdentifiers": { -"$ref": "AdIdentifiers", -"description": "Optional. Identifiers and other information used to match the conversion event with other online activity (such as ad clicks)." -}, -"additionalEventParameters": { -"description": "Optional. A bucket of any [event parameters](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events) to be included within the event that were not already specified using other structured fields.", +"attributes": { +"description": "Insights for values of a given dimension.", "items": { -"$ref": "EventParameter" +"$ref": "MarketingDataInsightsAttribute" }, "type": "array" }, -"cartData": { -"$ref": "CartData", -"description": "Optional. Information about the transaction and items associated with the event." +"dimension": { +"description": "The dimension to which the insight belongs.", +"enum": [ +"AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED", +"AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN", +"AFFINITY_USER_INTEREST", +"IN_MARKET_USER_INTEREST", +"AGE_RANGE", +"GENDER" +], +"enumDescriptions": [ +"Not specified.", +"The value is unknown in this version.", +"An Affinity UserInterest.", +"An In-Market UserInterest.", +"An age range.", +"A gender." +], +"type": "string" +} }, -"clientId": { -"description": "Optional. A unique identifier for the user instance of a web client for this GA4 web stream.", +"type": "object" +}, +"MarketingDataInsightsAttribute": { +"description": "Insights for a collection of related attributes of the same dimension.", +"id": "MarketingDataInsightsAttribute", +"properties": { +"ageRange": { +"description": "Age range of the audience for which the lift is provided.", +"enum": [ +"AGE_RANGE_UNSPECIFIED", +"AGE_RANGE_UNKNOWN", +"AGE_RANGE_18_24", +"AGE_RANGE_25_34", +"AGE_RANGE_35_44", +"AGE_RANGE_45_54", +"AGE_RANGE_55_64", +"AGE_RANGE_65_UP" +], +"enumDescriptions": [ +"Not specified.", +"Unknown.", +"Between 18 and 24 years old.", +"Between 25 and 34 years old.", +"Between 35 and 44 years old.", +"Between 45 and 54 years old.", +"Between 55 and 64 years old.", +"65 years old and beyond." +], "type": "string" }, -"consent": { -"$ref": "Consent", -"description": "Optional. Information about whether the associated user has provided different types of consent." +"gender": { +"description": "Gender of the audience for which the lift is provided.", +"enum": [ +"GENDER_UNSPECIFIED", +"GENDER_UNKNOWN", +"GENDER_MALE", +"GENDER_FEMALE" +], +"enumDescriptions": [ +"Not specified.", +"Unknown.", +"Male.", +"Female." +], +"type": "string" }, -"conversionValue": { -"description": "Optional. The conversion value associated with the event, for value-based conversions.", -"format": "double", +"lift": { +"description": "Measure of lift that the audience has for the attribute value as compared to the baseline. Range [0-1].", +"format": "float", "type": "number" }, -"currency": { -"description": "Optional. The currency code associated with all monetary values within this event.", +"userInterestId": { +"description": "The user interest ID.", +"format": "int64", "type": "string" +} }, -"customVariables": { -"description": "Optional. Additional key/value pair information to send to the conversion containers (conversion action or FL activity).", -"items": { -"$ref": "CustomVariable" -}, -"type": "array" +"type": "object" }, -"destinationReferences": { -"description": "Optional. Reference string used to determine the destination. If empty, the event will be sent to all destinations in the request.", +"MobileData": { +"description": "Mobile IDs for the audience. At least one mobile ID is required.", +"id": "MobileData", +"properties": { +"mobileIds": { +"description": "Required. The list of mobile device IDs (advertising ID/IDFA). At most 10 `mobileIds` can be provided in a single AudienceMember.", "items": { "type": "string" }, "type": "array" +} }, -"eventDeviceInfo": { -"$ref": "DeviceInfo", -"description": "Optional. Information gathered about the device being used (if any) when the event happened." +"type": "object" }, -"eventName": { -"description": "Optional. The name of the event. Required for GA4 events.", +"MobileIdInfo": { +"description": "Additional information when `MOBILE_ID` is one of the `upload_key_types`.", +"id": "MobileIdInfo", +"properties": { +"appId": { +"description": "Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.", "type": "string" }, -"eventSource": { -"description": "Optional. Signal for where the event happened (web, app, in-store, etc.).", +"dataSourceType": { +"description": "Optional. Immutable. Source of the upload data.", "enum": [ -"EVENT_SOURCE_UNSPECIFIED", -"WEB", -"APP", -"IN_STORE", -"PHONE", -"OTHER" +"DATA_SOURCE_TYPE_UNSPECIFIED", +"DATA_SOURCE_TYPE_FIRST_PARTY", +"DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU", +"DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE", +"DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" ], "enumDescriptions": [ -"Unspecified EventSource. Should never be used.", -"The event was generated from a web browser.", -"The event was generated from an app.", -"The event was generated from an in-store transaction.", -"The event was generated from a phone call.", -"The event was generated from other sources." +"Not specified.", +"The uploaded data is first-party data.", +"The uploaded data is from a third-party credit bureau.", +"The uploaded data is from a third-party voter file.", +"The uploaded data is third party partner data." ], "type": "string" }, -"eventTimestamp": { -"description": "Required. The time the event occurred.", -"format": "google-datetime", +"keySpace": { +"description": "Required. Immutable. The key space of mobile IDs.", +"enum": [ +"KEY_SPACE_UNSPECIFIED", +"IOS", +"ANDROID" +], +"enumDescriptions": [ +"Not specified.", +"The iOS keyspace.", +"The Android keyspace." +], "type": "string" +} }, -"experimentalFields": { -"description": "Optional. A list of key/value pairs for experimental fields that may eventually be promoted to be part of the API.", +"type": "object" +}, +"PairData": { +"description": "[PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required. This feature is only available to data partners.", +"id": "PairData", +"properties": { +"pairIds": { +"description": "Required. Cleanroom-provided PII data, hashed with SHA256, and encrypted with an EC commutative cipher using publisher key for the [PAIR]((//support.google.com/admanager/answer/15067908)) user list. At most 10 `pairIds` can be provided in a single AudienceMember.", "items": { -"$ref": "ExperimentalField" +"type": "string" }, "type": "array" +} }, -"lastUpdatedTimestamp": { -"description": "Optional. The last time the event was updated.", -"format": "google-datetime", +"type": "object" +}, +"PairIdInfo": { +"description": "Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.", +"id": "PairIdInfo", +"properties": { +"advertiserIdentifierCount": { +"description": "Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.", +"format": "int64", +"readOnly": true, "type": "string" }, -"transactionId": { -"description": "Optional. The unique identifier for this event. Required for conversions using multiple data sources.", +"cleanRoomIdentifier": { +"description": "Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.", "type": "string" }, -"userData": { -"$ref": "UserData", -"description": "Optional. Pieces of user provided data, representing the user the event is associated with." +"matchRatePercentage": { +"description": "Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.", +"format": "int32", +"readOnly": true, +"type": "integer" }, -"userId": { -"description": "Optional. A unique identifier for a user, as defined by the advertiser.", +"publisherId": { +"description": "Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.", +"format": "int64", "type": "string" }, -"userProperties": { -"$ref": "UserProperties", -"description": "Optional. Advertiser-assessed information about the user at the time that the event happened." +"publisherName": { +"description": "Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.", +"type": "string" } }, "type": "object" }, -"EventParameter": { -"description": "Event parameter for GA4 events.", -"id": "EventParameter", +"PartnerAudienceInfo": { +"description": "Additional information for partner audiences. This feature is only available to data partners.", +"id": "PartnerAudienceInfo", "properties": { -"parameterName": { -"description": "Required. The name of the parameter to use.", +"commercePartner": { +"description": "Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.", "type": "string" }, -"value": { -"description": "Required. The string representation of the value of the parameter to set.", +"partnerAudienceSource": { +"description": "Required. Immutable. The source of the partner audience.", +"enum": [ +"PARTNER_AUDIENCE_SOURCE_UNSPECIFIED", +"COMMERCE_AUDIENCE", +"LINEAR_TV_AUDIENCE", +"AGENCY_PROVIDER_AUDIENCE" +], +"enumDescriptions": [ +"Not specified.", +"Partner Audience source is commerce audience.", +"Partner Audience source is linear TV audience.", +"Partner Audience source is agency/provider audience." +], "type": "string" } }, "type": "object" }, -"ExperimentalField": { -"description": "Experimental field representing unofficial fields.", -"id": "ExperimentalField", +"PartnerLink": { +"description": "A partner link between an owning account and a partner account.", +"id": "PartnerLink", "properties": { -"field": { -"description": "Optional. The name of the field to use.", +"name": { +"description": "Identifier. The name of the partner link. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}", +"type": "string" +}, +"owningAccount": { +"$ref": "ProductAccount", +"description": "Required. The owning account granting access to the partner account." +}, +"partnerAccount": { +"$ref": "ProductAccount", +"description": "Required. The partner account granted access by the owning account." +}, +"partnerLinkId": { +"description": "Output only. The partner link ID.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"PpidData": { +"description": "Publisher provided identifiers data holding the ppids. At least one ppid is required. This feature is only available to data partners.", +"id": "PpidData", +"properties": { +"ppids": { +"description": "Required. The list of publisher provided identifiers for a user.", +"items": { "type": "string" }, -"value": { -"description": "Optional. The value the field to set.", -"type": "string" +"type": "array" } }, "type": "object" }, -"GcpWrappedKeyInfo": { -"description": "Information about the Google Cloud Platform wrapped key.", -"id": "GcpWrappedKeyInfo", +"ProductAccount": { +"description": "Represents a specific account.", +"id": "ProductAccount", "properties": { -"encryptedDek": { -"description": "Required. The base64 encoded encrypted data encryption key.", +"accountId": { +"description": "Required. The ID of the account. For example, your Google Ads account ID.", "type": "string" }, -"kekUri": { -"description": "Required. Google Cloud Platform [Cloud Key Management Service resource ID](//cloud.google.com/kms/docs/getting-resource-ids). Should be in the format of `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}` or `gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}`", +"accountType": { +"description": "Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.", +"enum": [ +"ACCOUNT_TYPE_UNSPECIFIED", +"GOOGLE_ADS", +"DISPLAY_VIDEO_PARTNER", +"DISPLAY_VIDEO_ADVERTISER", +"DATA_PARTNER", +"GOOGLE_ANALYTICS_PROPERTY", +"GOOGLE_AD_MANAGER_AUDIENCE_LINK" +], +"enumDescriptions": [ +"Unspecified product. Should never be used.", +"Google Ads.", +"Display & Video 360 partner.", +"Display & Video 360 advertiser.", +"Data Partner.", +"Google Analytics.", +"Google Ad Manager audience link." +], "type": "string" }, -"keyType": { -"description": "Required. The type of algorithm used to encrypt the data.", +"product": { +"deprecated": true, +"description": "Deprecated. Use `account_type` instead.", "enum": [ -"KEY_TYPE_UNSPECIFIED", -"XCHACHA20_POLY1305" +"PRODUCT_UNSPECIFIED", +"GOOGLE_ADS", +"DISPLAY_VIDEO_PARTNER", +"DISPLAY_VIDEO_ADVERTISER", +"DATA_PARTNER" ], "enumDescriptions": [ -"Unspecified key type. Should never be used.", -"Algorithm XChaCha20-Poly1305" +"Unspecified product. Should never be used.", +"Google Ads.", +"Display & Video 360 partner.", +"Display & Video 360 advertiser.", +"Data Partner." ], "type": "string" +} }, -"wipProvider": { -"description": "Required. The [Workload Identity](//cloud.google.com/iam/docs/workload-identity-federation) pool provider required to use KEK.", +"type": "object" +}, +"PseudonymousIdInfo": { +"description": "Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`.", +"id": "PseudonymousIdInfo", +"properties": { +"billableRecordCount": { +"description": "Optional. Immutable. The number of billable records (e.g. uploaded or matched).", +"format": "int64", +"type": "string" +}, +"syncStatus": { +"description": "Output only. Sync status of the user list.", +"enum": [ +"SYNC_STATUS_UNSPECIFIED", +"CREATED", +"READY_FOR_USE", +"FAILED" +], +"enumDescriptions": [ +"Not specified.", +"The user list has been created as a placeholder. List contents and/or metadata are still being synced. The user list is not ready for use.", +"The user list is ready for use. Contents and cookies have been synced correctly.", +"An error has occurred syncing user list contents and/or metadata. The user list cannot be used." +], +"readOnly": true, "type": "string" } }, "type": "object" }, -"IngestAudienceMembersRequest": { -"description": "Request to upload audience members to the provided destinations. Returns an IngestAudienceMembersResponse.", -"id": "IngestAudienceMembersRequest", +"RemoveAudienceMembersRequest": { +"description": "Request to remove users from an audience in the provided destinations. Returns a RemoveAudienceMembersResponse.", +"id": "RemoveAudienceMembersRequest", "properties": { "audienceMembers": { -"description": "Required. The list of users to send to the specified destinations. At most 10000 AudienceMember resources can be sent in a single request.", +"description": "Required. The list of users to remove.", "items": { "$ref": "AudienceMember" }, "type": "array" }, -"consent": { -"$ref": "Consent", -"description": "Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each AudienceMember." -}, "destinations": { -"description": "Required. The list of destinations to send the audience members to.", +"description": "Required. The list of destinations to remove the users from.", "items": { "$ref": "Destination" }, "type": "array" }, "encoding": { -"description": "Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non `UserData` uploads, this field is ignored.", +"description": "Optional. Required for UserData uploads. The encoding type of the user identifiers. Applies to only the outer encoding for encrypted user identifiers. For non `UserData` uploads, this field is ignored.", "enum": [ "ENCODING_UNSPECIFIED", "HEX", @@ -757,10 +2235,6 @@ "$ref": "EncryptionInfo", "description": "Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored." }, -"termsOfService": { -"$ref": "TermsOfService", -"description": "Optional. The terms of service that the user has accepted/rejected." -}, "validateOnly": { "description": "Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results.", "type": "boolean" @@ -768,9 +2242,9 @@ }, "type": "object" }, -"IngestAudienceMembersResponse": { -"description": "Response from the IngestAudienceMembersRequest.", -"id": "IngestAudienceMembersResponse", +"RemoveAudienceMembersResponse": { +"description": "Response from the RemoveAudienceMembersRequest.", +"id": "RemoveAudienceMembersResponse", "properties": { "requestId": { "description": "The auto-generated ID of the request.", @@ -779,564 +2253,852 @@ }, "type": "object" }, -"IngestAudienceMembersStatus": { -"description": "The status of the ingest audience members request.", -"id": "IngestAudienceMembersStatus", +"RemoveAudienceMembersStatus": { +"description": "The status of the remove audience members request.", +"id": "RemoveAudienceMembersStatus", "properties": { -"mobileDataIngestionStatus": { -"$ref": "IngestMobileDataStatus", -"description": "The status of the mobile data ingestion to the destination." +"mobileDataRemovalStatus": { +"$ref": "RemoveMobileDataStatus", +"description": "The status of the mobile data removal from the destination." }, -"pairDataIngestionStatus": { -"$ref": "IngestPairDataStatus", -"description": "The status of the pair data ingestion to the destination." +"pairDataRemovalStatus": { +"$ref": "RemovePairDataStatus", +"description": "The status of the pair data removal from the destination." }, -"userDataIngestionStatus": { -"$ref": "IngestUserDataStatus", -"description": "The status of the user data ingestion to the destination." +"ppidDataRemovalStatus": { +"$ref": "RemovePpidDataStatus", +"description": "The status of the ppid data removal from the destination." +}, +"userDataRemovalStatus": { +"$ref": "RemoveUserDataStatus", +"description": "The status of the user data removal from the destination." +}, +"userIdDataRemovalStatus": { +"$ref": "RemoveUserIdDataStatus", +"description": "The status of the user id data removal from the destination." } }, "type": "object" }, -"IngestEventsRequest": { -"description": "Request to upload audience members to the provided destinations. Returns an IngestEventsResponse.", -"id": "IngestEventsRequest", +"RemoveMobileDataStatus": { +"description": "The status of the mobile data removal from the destination.", +"id": "RemoveMobileDataStatus", "properties": { -"consent": { -"$ref": "Consent", -"description": "Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each Event." +"mobileIdCount": { +"description": "The total count of mobile Ids sent in the removal request. Includes all mobile ids in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" }, -"destinations": { -"description": "Required. The list of destinations to send the events to.", -"items": { -"$ref": "Destination" +"recordCount": { +"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +} }, -"type": "array" +"type": "object" }, -"encoding": { -"description": "Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non `UserData` uploads, this field is ignored.", +"RemovePairDataStatus": { +"description": "The status of the pair data removal from the destination.", +"id": "RemovePairDataStatus", +"properties": { +"pairIdCount": { +"description": "The total count of pair ids sent in the removal request. Includes all pair ids in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +}, +"recordCount": { +"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"RemovePpidDataStatus": { +"description": "The status of the ppid data removal from the destination.", +"id": "RemovePpidDataStatus", +"properties": { +"ppidCount": { +"description": "The total count of ppids sent in the removal request. Includes all ppids in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +}, +"recordCount": { +"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"RemoveUserDataStatus": { +"description": "The status of the user data removal from the destination.", +"id": "RemoveUserDataStatus", +"properties": { +"recordCount": { +"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +}, +"userIdentifierCount": { +"description": "The total count of user identifiers sent in the removal request. Includes all user identifiers in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"RemoveUserIdDataStatus": { +"description": "The status of the user id data removal from the destination.", +"id": "RemoveUserIdDataStatus", +"properties": { +"recordCount": { +"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +}, +"userIdCount": { +"description": "The total count of user ids sent in the removal request. Includes all user ids in the request, regardless of whether they were successfully removed or not.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"RequestStatusPerDestination": { +"description": "A request status per destination.", +"id": "RequestStatusPerDestination", +"properties": { +"audienceMembersIngestionStatus": { +"$ref": "IngestAudienceMembersStatus", +"description": "The status of the ingest audience members request." +}, +"audienceMembersRemovalStatus": { +"$ref": "RemoveAudienceMembersStatus", +"description": "The status of the remove audience members request." +}, +"destination": { +"$ref": "Destination", +"description": "A destination within a DM API request." +}, +"errorInfo": { +"$ref": "ErrorInfo", +"description": "An error info error containing the error reason and error counts related to the upload." +}, +"eventsIngestionStatus": { +"$ref": "IngestEventsStatus", +"description": "The status of the ingest events request." +}, +"requestStatus": { +"description": "The request status of the destination.", "enum": [ -"ENCODING_UNSPECIFIED", -"HEX", -"BASE64" +"REQUEST_STATUS_UNKNOWN", +"SUCCESS", +"PROCESSING", +"FAILED", +"PARTIAL_SUCCESS" ], "enumDescriptions": [ -"Unspecified Encoding type. Should never be used.", -"Hex encoding.", -"Base 64 encoding." +"The request status is unknown.", +"The request succeeded.", +"The request is processing.", +"The request failed.", +"The request partially succeeded." ], "type": "string" }, -"encryptionInfo": { -"$ref": "EncryptionInfo", -"description": "Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored." +"warningInfo": { +"$ref": "WarningInfo", +"description": "A warning info containing the warning reason and warning counts related to the upload." +} +}, +"type": "object" +}, +"RetrieveInsightsRequest": { +"description": "Request message for DM API MarketingDataInsightsService.RetrieveInsights", +"id": "RetrieveInsightsRequest", +"properties": { +"baseline": { +"$ref": "Baseline", +"description": "Required. Baseline for the insights requested." +}, +"userListId": { +"description": "Required. The user list ID for which insights are requested.", +"type": "string" +} }, -"events": { -"description": "Required. The list of events to send to the specified destinations. At most 2000 Event resources can be sent in a single request.", +"type": "object" +}, +"RetrieveInsightsResponse": { +"description": "Response message for DM API MarketingDataInsightsService.RetrieveInsights", +"id": "RetrieveInsightsResponse", +"properties": { +"marketingDataInsights": { +"description": "Contains the insights for the marketing data.", "items": { -"$ref": "Event" +"$ref": "MarketingDataInsight" }, "type": "array" -}, -"validateOnly": { -"description": "Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results.", -"type": "boolean" } }, "type": "object" }, -"IngestEventsResponse": { -"description": "Response from the IngestEventsRequest.", -"id": "IngestEventsResponse", +"RetrieveRequestStatusResponse": { +"description": "Response from the RetrieveRequestStatusRequest.", +"id": "RetrieveRequestStatusResponse", "properties": { -"requestId": { -"description": "The auto-generated ID of the request.", -"type": "string" +"requestStatusPerDestination": { +"description": "A list of request statuses per destination. The order of the statuses matches the order of the destinations in the original request.", +"items": { +"$ref": "RequestStatusPerDestination" +}, +"type": "array" } }, "type": "object" }, -"IngestEventsStatus": { -"description": "The status of the events ingestion to the destination.", -"id": "IngestEventsStatus", +"SearchPartnerLinksResponse": { +"description": "Response from the SearchPartnerLinksRequest.", +"id": "SearchPartnerLinksResponse", "properties": { -"recordCount": { -"description": "The total count of events sent in the upload request. Includes all events in the request, regardless of whether they were successfully ingested or not.", -"format": "int64", +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" +}, +"partnerLinks": { +"description": "The partner links for the given account.", +"items": { +"$ref": "PartnerLink" +}, +"type": "array" } }, "type": "object" }, -"IngestMobileDataStatus": { -"description": "The status of the mobile data ingestion to the destination containing stats related to the ingestion.", -"id": "IngestMobileDataStatus", +"SizeInfo": { +"description": "Estimated number of members in this user list in different target networks.", +"id": "SizeInfo", "properties": { -"mobileIdCount": { -"description": "The total count of mobile ids sent in the upload request for the destination. Includes all mobile ids in the request, regardless of whether they were successfully ingested or not.", +"displayNetworkMembersCount": { +"description": "Output only. Estimated number of members in this user list, on the Google Display Network.", "format": "int64", +"readOnly": true, "type": "string" }, -"recordCount": { -"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", +"searchNetworkMembersCount": { +"description": "Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.", "format": "int64", +"readOnly": true, "type": "string" } }, "type": "object" }, -"IngestPairDataStatus": { -"description": "The status of the pair data ingestion to the destination containing stats related to the ingestion.", -"id": "IngestPairDataStatus", +"Status": { +"description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", +"id": "Status", "properties": { -"pairIdCount": { -"description": "The total count of pair ids sent in the upload request for the destination. Includes all pair ids in the request, regardless of whether they were successfully ingested or not.", -"format": "int64", -"type": "string" +"code": { +"description": "The status code, which should be an enum value of google.rpc.Code.", +"format": "int32", +"type": "integer" }, -"recordCount": { -"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", -"format": "int64", +"details": { +"description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", +"items": { +"additionalProperties": { +"description": "Properties of the object. Contains field @type with type URL.", +"type": "any" +}, +"type": "object" +}, +"type": "array" +}, +"message": { +"description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" } }, "type": "object" }, -"IngestUserDataStatus": { -"description": "The status of the user data ingestion to the destination containing stats related to the ingestion.", -"id": "IngestUserDataStatus", +"TargetNetworkInfo": { +"description": "Eligibility information for different target networks.", +"id": "TargetNetworkInfo", "properties": { -"recordCount": { -"description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", -"format": "int64", -"type": "string" +"eligibleForDisplay": { +"description": "Output only. Indicates this user list is eligible for Google Display Network.", +"readOnly": true, +"type": "boolean" }, -"uploadMatchRateRange": { -"description": "The match rate range of the upload.", +"eligibleForSearch": { +"description": "Optional. Indicates if this user list is eligible for Google Search Network.", +"type": "boolean" +} +}, +"type": "object" +}, +"TermsOfService": { +"description": "The terms of service that the user has accepted/rejected.", +"id": "TermsOfService", +"properties": { +"customerMatchTermsOfServiceStatus": { +"description": "Optional. The Customer Match terms of service: https://support.google.com/adspolicy/answer/6299717. This must be accepted when ingesting UserData or MobileData. This field is not required for Partner Match User list.", "enum": [ -"MATCH_RATE_RANGE_UNKNOWN", -"MATCH_RATE_RANGE_NOT_ELIGIBLE", -"MATCH_RATE_RANGE_LESS_THAN_20", -"MATCH_RATE_RANGE_20_TO_30", -"MATCH_RATE_RANGE_31_TO_40", -"MATCH_RATE_RANGE_41_TO_50", -"MATCH_RATE_RANGE_51_TO_60", -"MATCH_RATE_RANGE_61_TO_70", -"MATCH_RATE_RANGE_71_TO_80", -"MATCH_RATE_RANGE_81_TO_90", -"MATCH_RATE_RANGE_91_TO_100" +"TERMS_OF_SERVICE_STATUS_UNSPECIFIED", +"ACCEPTED", +"REJECTED" ], "enumDescriptions": [ -"The match rate range is unknown.", -"The match rate range is not eligible.", -"The match rate range is less than 20% (in the interval `[0, 20)`).", -"The match rate range is between 20% and 30% (in the interval `[20, 31)`).", -"The match rate range is between 31% and 40% (in the interval `[31, 41)`).", -"The match rate range is between 41% and 50% (in the interval `[41, 51)`).", -"The match rate range is between 51% and 60% (in the interval `[51, 61)`.", -"The match rate range is between 61% and 70% (in the interval `[61, 71)`).", -"The match rate range is between 71% and 80% (in the interval `[71, 81)`).", -"The match rate range is between 81% and 90% (in the interval `[81, 91)`).", -"The match rate range is between 91% and 100% (in the interval `[91, 100]`)." +"Not specified.", +"Status indicating the caller has chosen to accept the terms of service.", +"Status indicating the caller has chosen to reject the terms of service." ], "type": "string" -}, -"userIdentifierCount": { -"description": "The total count of user identifiers sent in the upload request for the destination. Includes all user identifiers in the request, regardless of whether they were successfully ingested or not.", -"format": "int64", -"type": "string" } }, "type": "object" }, -"Item": { -"description": "Represents an item in the cart associated with the event.", -"id": "Item", +"UserData": { +"description": "Data that identifies the user. At least one identifier is required.", +"id": "UserData", "properties": { -"additionalItemParameters": { -"description": "Optional. A bucket of any [event parameters related to an item](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events) to be included within the event that were not already specified using other structured fields.", +"userIdentifiers": { +"description": "Required. The identifiers for the user. It's possible to provide multiple instances of the same type of data (for example, multiple email addresses). To increase the likelihood of a match, provide as many identifiers as possible. At most 10 `userIdentifiers` can be provided in a single AudienceMember or Event.", "items": { -"$ref": "ItemParameter" +"$ref": "UserIdentifier" }, "type": "array" +} }, -"itemId": { -"description": "Optional. A unique identifier to reference the item.", -"type": "string" +"type": "object" }, -"merchantProductId": { -"description": "Optional. The product ID within the Merchant Center account.", +"UserIdData": { +"description": "User id data holding the user id.", +"id": "UserIdData", +"properties": { +"userId": { +"description": "Required. A unique identifier for a user, as defined by the advertiser.", "type": "string" +} }, -"quantity": { -"description": "Optional. The number of this item associated with the event.", -"format": "int64", -"type": "string" +"type": "object" }, -"unitPrice": { -"description": "Optional. The unit price excluding tax, shipping, and any transaction level discounts.", -"format": "double", -"type": "number" +"UserIdInfo": { +"description": "Additional information when `USER_ID` is one of the `upload_key_types`.", +"id": "UserIdInfo", +"properties": { +"dataSourceType": { +"description": "Optional. Immutable. Source of the upload data.", +"enum": [ +"DATA_SOURCE_TYPE_UNSPECIFIED", +"DATA_SOURCE_TYPE_FIRST_PARTY", +"DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU", +"DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE", +"DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" +], +"enumDescriptions": [ +"Not specified.", +"The uploaded data is first-party data.", +"The uploaded data is from a third-party credit bureau.", +"The uploaded data is from a third-party voter file.", +"The uploaded data is third party partner data." +], +"type": "string" } }, "type": "object" }, -"ItemParameter": { -"description": "A bucket of any [event parameters related to an item](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events) to be included within the event that were not already specified using other structured fields.", -"id": "ItemParameter", +"UserIdentifier": { +"description": "A single identifier for the user.", +"id": "UserIdentifier", "properties": { -"parameterName": { -"description": "Required. The name of the parameter to use.", +"address": { +"$ref": "AddressInfo", +"description": "The known components of a user's address. Holds a grouping of identifiers that are matched all at once." +}, +"emailAddress": { +"description": "Hashed email address using SHA-256 hash function after normalization.", "type": "string" }, -"value": { -"description": "Required. The string representation of the value of the parameter to set.", +"phoneNumber": { +"description": "Hashed phone number using SHA-256 hash function after normalization (E164 standard).", "type": "string" } }, "type": "object" }, -"MobileData": { -"description": "Mobile IDs for the audience. At least one mobile ID is required.", -"id": "MobileData", +"UserList": { +"description": "A user list resource.", +"id": "UserList", "properties": { -"mobileIds": { -"description": "Required. The list of mobile device IDs (advertising ID/IDFA). At most 10 `mobileIds` can be provided in a single AudienceMember.", -"items": { +"accessReason": { +"description": "Output only. The reason this account has been granted access to the list.", +"enum": [ +"ACCESS_REASON_UNSPECIFIED", +"OWNED", +"SHARED", +"LICENSED", +"SUBSCRIBED", +"AFFILIATED" +], +"enumDescriptions": [ +"Not specified.", +"The resource is owned by the user.", +"The resource is shared to the user.", +"The resource is licensed to the user.", +"The user subscribed to the resource.", +"The resource is accessible to the user." +], +"readOnly": true, "type": "string" }, -"type": "array" -} +"accountAccessStatus": { +"description": "Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.", +"enum": [ +"ACCESS_STATUS_UNSPECIFIED", +"ENABLED", +"DISABLED" +], +"enumDescriptions": [ +"Not specified.", +"The access is enabled.", +"The access is disabled." +], +"type": "string" }, -"type": "object" +"closingReason": { +"description": "Output only. The reason why this user list membership status is closed.", +"enum": [ +"CLOSING_REASON_UNSPECIFIED", +"UNUSED" +], +"enumDescriptions": [ +"Not specified.", +"The user list was closed because it has not been used in targeting recently. See https://support.google.com/google-ads/answer/2472738 for details." +], +"readOnly": true, +"type": "string" }, -"PairData": { -"description": "[PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required.", -"id": "PairData", -"properties": { -"pairIds": { -"description": "Required. Cleanroom-provided PII data, hashed with SHA256, and encrypted with an EC commutative cipher using publisher key for the [PAIR]((//support.google.com/admanager/answer/15067908)) user list. At most 10 `pairIds` can be provided in a single AudienceMember.", -"items": { +"description": { +"description": "Optional. A description of the user list.", "type": "string" }, -"type": "array" -} +"displayName": { +"description": "Required. The display name of the user list.", +"type": "string" }, -"type": "object" +"id": { +"description": "Output only. The unique ID of the user list.", +"format": "int64", +"readOnly": true, +"type": "string" }, -"ProductAccount": { -"description": "Represents a specific account.", -"id": "ProductAccount", -"properties": { -"accountId": { -"description": "Required. The ID of the account. For example, your Google Ads account ID.", +"ingestedUserListInfo": { +"$ref": "IngestedUserListInfo", +"description": "Optional. Represents a user list that is populated by user ingested data." +}, +"integrationCode": { +"description": "Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.", "type": "string" }, -"accountType": { -"description": "Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match.", +"membershipDuration": { +"description": "Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.", +"format": "google-duration", +"type": "string" +}, +"membershipStatus": { +"description": "Optional. Membership status of this user list.", "enum": [ -"ACCOUNT_TYPE_UNSPECIFIED", -"GOOGLE_ADS", -"DISPLAY_VIDEO_PARTNER", -"DISPLAY_VIDEO_ADVERTISER", -"DATA_PARTNER", -"GOOGLE_ANALYTICS_PROPERTY" +"MEMBERSHIP_STATUS_UNSPECIFIED", +"OPEN", +"CLOSED" ], "enumDescriptions": [ -"Unspecified product. Should never be used.", -"Google Ads.", -"Display & Video 360 partner.", -"Display & Video 360 advertiser.", -"Data Partner.", -"Google Analytics." +"Not specified.", +"Open status - User list is accruing members and can be targeted to.", +"Closed status - No new members being added." ], "type": "string" }, -"product": { -"deprecated": true, -"description": "Deprecated. Use `account_type` instead.", +"name": { +"description": "Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", +"type": "string" +}, +"readOnly": { +"description": "Output only. An option that indicates if a user may edit a list.", +"readOnly": true, +"type": "boolean" +}, +"sizeInfo": { +"$ref": "SizeInfo", +"description": "Output only. Estimated number of members in this user list in different target networks.", +"readOnly": true +}, +"targetNetworkInfo": { +"$ref": "TargetNetworkInfo", +"description": "Optional. Eligibility information for different target networks." +} +}, +"type": "object" +}, +"UserListDirectLicense": { +"description": "A user list direct license. This feature is only available to data partners.", +"id": "UserListDirectLicense", +"properties": { +"clientAccountDisplayName": { +"description": "Output only. Name of client customer which the user list is being licensed to. This field is read-only.", +"readOnly": true, +"type": "string" +}, +"clientAccountId": { +"description": "Immutable. ID of client customer which the user list is being licensed to.", +"format": "int64", +"type": "string" +}, +"clientAccountType": { +"description": "Immutable. Account type of client customer which the user list is being licensed to.", "enum": [ -"PRODUCT_UNSPECIFIED", -"GOOGLE_ADS", -"DISPLAY_VIDEO_PARTNER", -"DISPLAY_VIDEO_ADVERTISER", -"DATA_PARTNER" +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK" ], "enumDescriptions": [ -"Unspecified product. Should never be used.", -"Google Ads.", +"Unknown.", +"Google Ads customer.", "Display & Video 360 partner.", "Display & Video 360 advertiser.", -"Data Partner." +"Google Ad Manager audience link." ], "type": "string" -} -}, -"type": "object" }, -"RemoveAudienceMembersRequest": { -"description": "Request to remove users from an audience in the provided destinations. Returns a RemoveAudienceMembersResponse.", -"id": "RemoveAudienceMembersRequest", -"properties": { -"audienceMembers": { -"description": "Required. The list of users to remove.", +"historicalPricings": { +"description": "Output only. Pricing history of this user list license. This field is read-only.", "items": { -"$ref": "AudienceMember" +"$ref": "UserListLicensePricing" }, +"readOnly": true, "type": "array" }, -"destinations": { -"description": "Required. The list of destinations to remove the users from.", -"items": { -"$ref": "Destination" +"metrics": { +"$ref": "UserListLicenseMetrics", +"description": "Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call", +"readOnly": true }, -"type": "array" +"name": { +"description": "Identifier. The resource name of the user list direct license.", +"type": "string" }, -"encoding": { -"description": "Optional. Required for UserData uploads. The encoding type of the user identifiers. Applies to only the outer encoding for encrypted user identifiers. For non `UserData` uploads, this field is ignored.", +"pricing": { +"$ref": "UserListLicensePricing", +"description": "Optional. UserListDirectLicense pricing." +}, +"status": { +"description": "Optional. Status of UserListDirectLicense - ENABLED or DISABLED.", "enum": [ -"ENCODING_UNSPECIFIED", -"HEX", -"BASE64" +"USER_LIST_LICENSE_STATUS_UNSPECIFIED", +"USER_LIST_LICENSE_STATUS_ENABLED", +"USER_LIST_LICENSE_STATUS_DISABLED" ], "enumDescriptions": [ -"Unspecified Encoding type. Should never be used.", -"Hex encoding.", -"Base 64 encoding." +"Unknown.", +"Active status - user list is still being licensed.", +"Inactive status - user list is no longer being licensed." ], "type": "string" }, -"encryptionInfo": { -"$ref": "EncryptionInfo", -"description": "Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored." -}, -"validateOnly": { -"description": "Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results.", -"type": "boolean" -} -}, -"type": "object" +"userListDisplayName": { +"description": "Output only. Name of the user list being licensed. This field is read-only.", +"readOnly": true, +"type": "string" }, -"RemoveAudienceMembersResponse": { -"description": "Response from the RemoveAudienceMembersRequest.", -"id": "RemoveAudienceMembersResponse", -"properties": { -"requestId": { -"description": "The auto-generated ID of the request.", +"userListId": { +"description": "Immutable. ID of the user list being licensed.", +"format": "int64", "type": "string" } }, "type": "object" }, -"RemoveAudienceMembersStatus": { -"description": "The status of the remove audience members request.", -"id": "RemoveAudienceMembersStatus", +"UserListGlobalLicense": { +"description": "A user list global license. This feature is only available to data partners.", +"id": "UserListGlobalLicense", "properties": { -"mobileDataRemovalStatus": { -"$ref": "RemoveMobileDataStatus", -"description": "The status of the mobile data removal from the destination." +"historicalPricings": { +"description": "Output only. Pricing history of this user list license. This field is read-only.", +"items": { +"$ref": "UserListLicensePricing" }, -"pairDataRemovalStatus": { -"$ref": "RemovePairDataStatus", -"description": "The status of the pair data removal from the destination." +"readOnly": true, +"type": "array" }, -"userDataRemovalStatus": { -"$ref": "RemoveUserDataStatus", -"description": "The status of the user data removal from the destination." -} +"licenseType": { +"description": "Immutable. Product type of client customer which the user list is being licensed to.", +"enum": [ +"USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED", +"USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER", +"USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE", +"USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE" +], +"enumDescriptions": [ +"UNSPECIFIED.", +"Reseller license.", +"DataMart Sell Side license.", +"DataMart Buy Side license." +], +"type": "string" }, -"type": "object" +"metrics": { +"$ref": "UserListLicenseMetrics", +"description": "Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call", +"readOnly": true }, -"RemoveMobileDataStatus": { -"description": "The status of the mobile data removal from the destination.", -"id": "RemoveMobileDataStatus", -"properties": { -"mobileIdCount": { -"description": "The total count of mobile Ids sent in the removal request. Includes all mobile ids in the request, regardless of whether they were successfully removed or not.", -"format": "int64", +"name": { +"description": "Identifier. The resource name of the user list global license.", "type": "string" }, -"recordCount": { -"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", -"format": "int64", -"type": "string" -} +"pricing": { +"$ref": "UserListLicensePricing", +"description": "Optional. UserListGlobalLicense pricing." }, -"type": "object" +"status": { +"description": "Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.", +"enum": [ +"USER_LIST_LICENSE_STATUS_UNSPECIFIED", +"USER_LIST_LICENSE_STATUS_ENABLED", +"USER_LIST_LICENSE_STATUS_DISABLED" +], +"enumDescriptions": [ +"Unknown.", +"Active status - user list is still being licensed.", +"Inactive status - user list is no longer being licensed." +], +"type": "string" }, -"RemovePairDataStatus": { -"description": "The status of the pair data removal from the destination.", -"id": "RemovePairDataStatus", -"properties": { -"pairIdCount": { -"description": "The total count of pair ids sent in the removal request. Includes all pair ids in the request, regardless of whether they were successfully removed or not.", -"format": "int64", +"userListDisplayName": { +"description": "Output only. Name of the user list being licensed. This field is read-only.", +"readOnly": true, "type": "string" }, -"recordCount": { -"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", +"userListId": { +"description": "Immutable. ID of the user list being licensed.", "format": "int64", "type": "string" } }, "type": "object" }, -"RemoveUserDataStatus": { -"description": "The status of the user data removal from the destination.", -"id": "RemoveUserDataStatus", +"UserListGlobalLicenseCustomerInfo": { +"description": "Information about a customer of a user list global license. This will automatically be created by the system when a customer purchases a global license.", +"id": "UserListGlobalLicenseCustomerInfo", "properties": { -"recordCount": { -"description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", -"format": "int64", +"clientAccountDisplayName": { +"description": "Output only. Name of client customer which the user list is being licensed to.", +"readOnly": true, "type": "string" }, -"userIdentifierCount": { -"description": "The total count of user identifiers sent in the removal request. Includes all user identifiers in the request, regardless of whether they were successfully removed or not.", +"clientAccountId": { +"description": "Output only. ID of client customer which the user list is being licensed to.", "format": "int64", +"readOnly": true, "type": "string" -} }, -"type": "object" +"clientAccountType": { +"description": "Output only. Product type of client customer which the user list is being licensed to.", +"enum": [ +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER", +"USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK" +], +"enumDescriptions": [ +"Unknown.", +"Google Ads customer.", +"Display & Video 360 partner.", +"Display & Video 360 advertiser.", +"Google Ad Manager audience link." +], +"readOnly": true, +"type": "string" }, -"RequestStatusPerDestination": { -"description": "A request status per destination.", -"id": "RequestStatusPerDestination", -"properties": { -"audienceMembersIngestionStatus": { -"$ref": "IngestAudienceMembersStatus", -"description": "The status of the ingest audience members request." +"historicalPricings": { +"description": "Output only. Pricing history of this user list license.", +"items": { +"$ref": "UserListLicensePricing" }, -"audienceMembersRemovalStatus": { -"$ref": "RemoveAudienceMembersStatus", -"description": "The status of the remove audience members request." +"readOnly": true, +"type": "array" }, -"destination": { -"$ref": "Destination", -"description": "A destination within a DM API request." +"licenseType": { +"description": "Output only. Product type of client customer which the user list is being licensed to.", +"enum": [ +"USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED", +"USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER", +"USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE", +"USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE" +], +"enumDescriptions": [ +"UNSPECIFIED.", +"Reseller license.", +"DataMart Sell Side license.", +"DataMart Buy Side license." +], +"readOnly": true, +"type": "string" }, -"errorInfo": { -"$ref": "ErrorInfo", -"description": "An error info error containing the error reason and error counts related to the upload." +"metrics": { +"$ref": "UserListLicenseMetrics", +"description": "Output only. Metrics related to this license This field is only populated if the start and end dates are set in the ListUserListGlobalLicenseCustomerInfos call.", +"readOnly": true }, -"eventsIngestionStatus": { -"$ref": "IngestEventsStatus", -"description": "The status of the ingest events request." +"name": { +"description": "Identifier. The resource name of the user list global license customer.", +"type": "string" }, -"requestStatus": { -"description": "The request status of the destination.", +"pricing": { +"$ref": "UserListLicensePricing", +"description": "Output only. UserListDirectLicense pricing.", +"readOnly": true +}, +"status": { +"description": "Output only. Status of UserListDirectLicense - ENABLED or DISABLED.", "enum": [ -"REQUEST_STATUS_UNKNOWN", -"SUCCESS", -"PROCESSING", -"FAILED", -"PARTIAL_SUCCESS" +"USER_LIST_LICENSE_STATUS_UNSPECIFIED", +"USER_LIST_LICENSE_STATUS_ENABLED", +"USER_LIST_LICENSE_STATUS_DISABLED" ], "enumDescriptions": [ -"The request status is unknown.", -"The request succeeded.", -"The request is processing.", -"The request failed.", -"The request partially succeeded." +"Unknown.", +"Active status - user list is still being licensed.", +"Inactive status - user list is no longer being licensed." ], +"readOnly": true, "type": "string" }, -"warningInfo": { -"$ref": "WarningInfo", -"description": "A warning info containing the warning reason and warning counts related to the upload." -} -}, -"type": "object" -}, -"RetrieveRequestStatusResponse": { -"description": "Response from the RetrieveRequestStatusRequest.", -"id": "RetrieveRequestStatusResponse", -"properties": { -"requestStatusPerDestination": { -"description": "A list of request statuses per destination. The order of the statuses matches the order of the destinations in the original request.", -"items": { -"$ref": "RequestStatusPerDestination" +"userListDisplayName": { +"description": "Output only. Name of the user list being licensed.", +"readOnly": true, +"type": "string" }, -"type": "array" +"userListId": { +"description": "Output only. ID of the user list being licensed.", +"format": "int64", +"readOnly": true, +"type": "string" } }, "type": "object" }, -"Status": { -"description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", -"id": "Status", +"UserListLicenseMetrics": { +"description": "Metrics related to a user list license.", +"id": "UserListLicenseMetrics", "properties": { -"code": { -"description": "The status code, which should be an enum value of google.rpc.Code.", -"format": "int32", -"type": "integer" +"clickCount": { +"description": "Output only. The number of clicks for the user list license.", +"format": "int64", +"readOnly": true, +"type": "string" }, -"details": { -"description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", -"items": { -"additionalProperties": { -"description": "Properties of the object. Contains field @type with type URL.", -"type": "any" +"endDate": { +"description": "Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.", +"format": "int64", +"readOnly": true, +"type": "string" }, -"type": "object" +"impressionCount": { +"description": "Output only. The number of impressions for the user list license.", +"format": "int64", +"readOnly": true, +"type": "string" }, -"type": "array" +"revenueUsdMicros": { +"description": "Output only. The revenue for the user list license in USD micros.", +"format": "int64", +"readOnly": true, +"type": "string" }, -"message": { -"description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", +"startDate": { +"description": "Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.", +"format": "int64", +"readOnly": true, "type": "string" } }, "type": "object" }, -"TermsOfService": { -"description": "The terms of service that the user has accepted/rejected.", -"id": "TermsOfService", +"UserListLicensePricing": { +"description": "A user list license pricing.", +"id": "UserListLicensePricing", "properties": { -"customerMatchTermsOfServiceStatus": { -"description": "Optional. The Customer Match terms of service: https://support.google.com/adspolicy/answer/6299717. This must be accepted when ingesting UserData or MobileData. This field is not required for Partner Match User list.", +"buyerApprovalState": { +"description": "Output only. The buyer approval state of this pricing. This field is read-only.", "enum": [ -"TERMS_OF_SERVICE_STATUS_UNSPECIFIED", -"ACCEPTED", +"USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED", +"PENDING", +"APPROVED", "REJECTED" ], "enumDescriptions": [ -"Not specified.", -"Status indicating the caller has chosen to accept the terms of service.", -"Status indicating the caller has chosen to reject the terms of service." +"UNSPECIFIED.", +"User list client has not yet accepted the pricing terms set by the user list owner.", +"User list client has accepted the pricing terms set by the user list owner.", +"User list client has rejected the pricing terms set by the user list owner." ], +"readOnly": true, "type": "string" -} }, -"type": "object" +"costMicros": { +"description": "Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.", +"format": "int64", +"type": "string" }, -"UserData": { -"description": "Data that identifies the user. At least one identifier is required.", -"id": "UserData", -"properties": { -"userIdentifiers": { -"description": "Required. The identifiers for the user. It's possible to provide multiple instances of the same type of data (for example, multiple email addresses). To increase the likelihood of a match, provide as many identifiers as possible. At most 10 `userIdentifiers` can be provided in a single AudienceMember or Event.", -"items": { -"$ref": "UserIdentifier" +"costType": { +"description": "Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.", +"enum": [ +"USER_LIST_PRICING_COST_TYPE_UNSPECIFIED", +"CPC", +"CPM", +"MEDIA_SHARE" +], +"enumDescriptions": [ +"Unspecified.", +"Cost per click.", +"Cost per mille (thousand impressions).", +"Media share." +], +"type": "string" }, -"type": "array" -} +"currencyCode": { +"description": "Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.", +"type": "string" }, -"type": "object" +"endTime": { +"description": "Optional. End time of the pricing.", +"format": "google-datetime", +"type": "string" }, -"UserIdentifier": { -"description": "A single identifier for the user.", -"id": "UserIdentifier", -"properties": { -"address": { -"$ref": "AddressInfo", -"description": "The known components of a user's address. Holds a grouping of identifiers that are matched all at once." +"maxCostMicros": { +"description": "Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.", +"format": "int64", +"type": "string" }, -"emailAddress": { -"description": "Hashed email address using SHA-256 hash function after normalization.", +"pricingActive": { +"description": "Output only. Whether this pricing is active.", +"readOnly": true, +"type": "boolean" +}, +"pricingId": { +"description": "Output only. The ID of this pricing.", +"format": "int64", +"readOnly": true, "type": "string" }, -"phoneNumber": { -"description": "Hashed phone number using SHA-256 hash function after normalization (E164 standard).", +"startTime": { +"description": "Output only. Start time of the pricing.", +"format": "google-datetime", +"readOnly": true, "type": "string" } }, From c18e222aa0eeab937f78b2be0719c031e1686fbb Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:56 +0000 Subject: [PATCH 09/29] feat(dataplex): update the api #### dataplex:v1 The following keys were added: - resources.projects.resources.locations.methods.lookupEntryLinks (Total Keys: 23) - schemas.GoogleCloudDataplexV1DataQualityRule.properties.debugQueries (Total Keys: 2) - schemas.GoogleCloudDataplexV1DataQualityRuleDebugQuery (Total Keys: 3) - schemas.GoogleCloudDataplexV1DataQualityRuleResult.properties.debugQueriesResultSets (Total Keys: 3) - schemas.GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult (Total Keys: 10) - schemas.GoogleCloudDataplexV1LookupEntryLinksResponse (Total Keys: 5) --- ...aplex_v1.projects.locations.dataScans.html | 121 +++++++++++++++ ..._v1.projects.locations.dataScans.jobs.html | 52 +++++++ docs/dyn/dataplex_v1.projects.locations.html | 63 ++++++++ .../documents/dataplex.v1.json | 146 +++++++++++++++++- 4 files changed, 381 insertions(+), 1 deletion(-) diff --git a/docs/dyn/dataplex_v1.projects.locations.dataScans.html b/docs/dyn/dataplex_v1.projects.locations.dataScans.html index 1c65b1b25f3..1a0c368a0c0 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataScans.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataScans.html @@ -337,6 +337,17 @@

Method Details

"rules": [ # Output only. A list of all the rules in a job, and their results. { # DataQualityRuleResult provides a more detailed, per-rule view of the results. "assertionRowCount": "A String", # Output only. The number of rows returned by the SQL statement in a SQL assertion rule.This field is only valid for SQL assertion rules. + "debugQueriesResultSets": [ # Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries. + { # Contains all results from a debug query. + "results": [ # Output only. Contains all results. Up to 10 results can be returned. + { # Contains a single result from the debug query. + "name": "A String", # Specifies the name of the result. Available if provided with an explicit alias using [AS] alias. + "type": "A String", # Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + "value": "A String", # Represents the value of the result as a string. + }, + ], + }, + ], "evaluatedCount": "A String", # Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion. "failingRowsQuery": "A String", # Output only. The query to find rows that did not pass this rule.This field is only valid for row-level type rules. "nullCount": "A String", # Output only. The number of rows with null values in the specified column. @@ -345,6 +356,12 @@

Method Details

"passedCount": "A String", # Output only. The number of rows which passed a rule evaluation.This field is only valid for row-level type rules.This field is not set for rule SqlAssertion. "rule": { # A rule captures data quality intent about a data source. # Output only. The rule specified in the DataQualitySpec, as is. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -422,6 +439,12 @@

Method Details

"rules": [ # Required. The list of rules to evaluate against a data source. At least one rule is required. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -587,6 +610,12 @@

Method Details

"rule": [ # The data quality rules that Dataplex Universal Catalog generates based on the results of a data profiling scan. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -858,6 +887,17 @@

Method Details

"rules": [ # Output only. A list of all the rules in a job, and their results. { # DataQualityRuleResult provides a more detailed, per-rule view of the results. "assertionRowCount": "A String", # Output only. The number of rows returned by the SQL statement in a SQL assertion rule.This field is only valid for SQL assertion rules. + "debugQueriesResultSets": [ # Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries. + { # Contains all results from a debug query. + "results": [ # Output only. Contains all results. Up to 10 results can be returned. + { # Contains a single result from the debug query. + "name": "A String", # Specifies the name of the result. Available if provided with an explicit alias using [AS] alias. + "type": "A String", # Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + "value": "A String", # Represents the value of the result as a string. + }, + ], + }, + ], "evaluatedCount": "A String", # Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion. "failingRowsQuery": "A String", # Output only. The query to find rows that did not pass this rule.This field is only valid for row-level type rules. "nullCount": "A String", # Output only. The number of rows with null values in the specified column. @@ -866,6 +906,12 @@

Method Details

"passedCount": "A String", # Output only. The number of rows which passed a rule evaluation.This field is only valid for row-level type rules.This field is not set for rule SqlAssertion. "rule": { # A rule captures data quality intent about a data source. # Output only. The rule specified in the DataQualitySpec, as is. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -943,6 +989,12 @@

Method Details

"rules": [ # Required. The list of rules to evaluate against a data source. At least one rule is required. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -1293,6 +1345,17 @@

Method Details

"rules": [ # Output only. A list of all the rules in a job, and their results. { # DataQualityRuleResult provides a more detailed, per-rule view of the results. "assertionRowCount": "A String", # Output only. The number of rows returned by the SQL statement in a SQL assertion rule.This field is only valid for SQL assertion rules. + "debugQueriesResultSets": [ # Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries. + { # Contains all results from a debug query. + "results": [ # Output only. Contains all results. Up to 10 results can be returned. + { # Contains a single result from the debug query. + "name": "A String", # Specifies the name of the result. Available if provided with an explicit alias using [AS] alias. + "type": "A String", # Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + "value": "A String", # Represents the value of the result as a string. + }, + ], + }, + ], "evaluatedCount": "A String", # Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion. "failingRowsQuery": "A String", # Output only. The query to find rows that did not pass this rule.This field is only valid for row-level type rules. "nullCount": "A String", # Output only. The number of rows with null values in the specified column. @@ -1301,6 +1364,12 @@

Method Details

"passedCount": "A String", # Output only. The number of rows which passed a rule evaluation.This field is only valid for row-level type rules.This field is not set for rule SqlAssertion. "rule": { # A rule captures data quality intent about a data source. # Output only. The rule specified in the DataQualitySpec, as is. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -1378,6 +1447,12 @@

Method Details

"rules": [ # Required. The list of rules to evaluate against a data source. At least one rule is required. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -1689,6 +1764,17 @@

Method Details

"rules": [ # Output only. A list of all the rules in a job, and their results. { # DataQualityRuleResult provides a more detailed, per-rule view of the results. "assertionRowCount": "A String", # Output only. The number of rows returned by the SQL statement in a SQL assertion rule.This field is only valid for SQL assertion rules. + "debugQueriesResultSets": [ # Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries. + { # Contains all results from a debug query. + "results": [ # Output only. Contains all results. Up to 10 results can be returned. + { # Contains a single result from the debug query. + "name": "A String", # Specifies the name of the result. Available if provided with an explicit alias using [AS] alias. + "type": "A String", # Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + "value": "A String", # Represents the value of the result as a string. + }, + ], + }, + ], "evaluatedCount": "A String", # Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion. "failingRowsQuery": "A String", # Output only. The query to find rows that did not pass this rule.This field is only valid for row-level type rules. "nullCount": "A String", # Output only. The number of rows with null values in the specified column. @@ -1697,6 +1783,12 @@

Method Details

"passedCount": "A String", # Output only. The number of rows which passed a rule evaluation.This field is only valid for row-level type rules.This field is not set for rule SqlAssertion. "rule": { # A rule captures data quality intent about a data source. # Output only. The rule specified in the DataQualitySpec, as is. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -1774,6 +1866,12 @@

Method Details

"rules": [ # Required. The list of rules to evaluate against a data source. At least one rule is required. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -2103,6 +2201,17 @@

Method Details

"rules": [ # Output only. A list of all the rules in a job, and their results. { # DataQualityRuleResult provides a more detailed, per-rule view of the results. "assertionRowCount": "A String", # Output only. The number of rows returned by the SQL statement in a SQL assertion rule.This field is only valid for SQL assertion rules. + "debugQueriesResultSets": [ # Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries. + { # Contains all results from a debug query. + "results": [ # Output only. Contains all results. Up to 10 results can be returned. + { # Contains a single result from the debug query. + "name": "A String", # Specifies the name of the result. Available if provided with an explicit alias using [AS] alias. + "type": "A String", # Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + "value": "A String", # Represents the value of the result as a string. + }, + ], + }, + ], "evaluatedCount": "A String", # Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion. "failingRowsQuery": "A String", # Output only. The query to find rows that did not pass this rule.This field is only valid for row-level type rules. "nullCount": "A String", # Output only. The number of rows with null values in the specified column. @@ -2111,6 +2220,12 @@

Method Details

"passedCount": "A String", # Output only. The number of rows which passed a rule evaluation.This field is only valid for row-level type rules.This field is not set for rule SqlAssertion. "rule": { # A rule captures data quality intent about a data source. # Output only. The rule specified in the DataQualitySpec, as is. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -2188,6 +2303,12 @@

Method Details

"rules": [ # Required. The list of rules to evaluate against a data source. At least one rule is required. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation diff --git a/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html b/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html index 1838f758d07..d8a0908535e 100644 --- a/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html +++ b/docs/dyn/dataplex_v1.projects.locations.dataScans.jobs.html @@ -119,6 +119,12 @@

Method Details

"rule": [ # The data quality rules that Dataplex Universal Catalog generates based on the results of a data profiling scan. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -386,6 +392,17 @@

Method Details

"rules": [ # Output only. A list of all the rules in a job, and their results. { # DataQualityRuleResult provides a more detailed, per-rule view of the results. "assertionRowCount": "A String", # Output only. The number of rows returned by the SQL statement in a SQL assertion rule.This field is only valid for SQL assertion rules. + "debugQueriesResultSets": [ # Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries. + { # Contains all results from a debug query. + "results": [ # Output only. Contains all results. Up to 10 results can be returned. + { # Contains a single result from the debug query. + "name": "A String", # Specifies the name of the result. Available if provided with an explicit alias using [AS] alias. + "type": "A String", # Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + "value": "A String", # Represents the value of the result as a string. + }, + ], + }, + ], "evaluatedCount": "A String", # Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion. "failingRowsQuery": "A String", # Output only. The query to find rows that did not pass this rule.This field is only valid for row-level type rules. "nullCount": "A String", # Output only. The number of rows with null values in the specified column. @@ -394,6 +411,12 @@

Method Details

"passedCount": "A String", # Output only. The number of rows which passed a rule evaluation.This field is only valid for row-level type rules.This field is not set for rule SqlAssertion. "rule": { # A rule captures data quality intent about a data source. # Output only. The rule specified in the DataQualitySpec, as is. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -471,6 +494,12 @@

Method Details

"rules": [ # Required. The list of rules to evaluate against a data source. At least one rule is required. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -747,6 +776,17 @@

Method Details

"rules": [ # Output only. A list of all the rules in a job, and their results. { # DataQualityRuleResult provides a more detailed, per-rule view of the results. "assertionRowCount": "A String", # Output only. The number of rows returned by the SQL statement in a SQL assertion rule.This field is only valid for SQL assertion rules. + "debugQueriesResultSets": [ # Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries. + { # Contains all results from a debug query. + "results": [ # Output only. Contains all results. Up to 10 results can be returned. + { # Contains a single result from the debug query. + "name": "A String", # Specifies the name of the result. Available if provided with an explicit alias using [AS] alias. + "type": "A String", # Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + "value": "A String", # Represents the value of the result as a string. + }, + ], + }, + ], "evaluatedCount": "A String", # Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion. "failingRowsQuery": "A String", # Output only. The query to find rows that did not pass this rule.This field is only valid for row-level type rules. "nullCount": "A String", # Output only. The number of rows with null values in the specified column. @@ -755,6 +795,12 @@

Method Details

"passedCount": "A String", # Output only. The number of rows which passed a rule evaluation.This field is only valid for row-level type rules.This field is not set for rule SqlAssertion. "rule": { # A rule captures data quality intent about a data source. # Output only. The rule specified in the DataQualitySpec, as is. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation @@ -832,6 +878,12 @@

Method Details

"rules": [ # Required. The list of rules to evaluate against a data source. At least one rule is required. { # A rule captures data quality intent about a data source. "column": "A String", # Optional. The unnested column which this rule is evaluated against. + "debugQueries": [ # Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future. + { # Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} + "description": "A String", # Optional. Specifies the description of the debug query. The maximum length is 1,024 characters. + "sqlStatement": "A String", # Required. Specifies the SQL statement to be executed. + }, + ], "description": "A String", # Optional. Description of the rule. The maximum length is 1,024 characters. "dimension": "A String", # Optional. The dimension a rule belongs to. Results are also aggregated at the dimension level. Custom dimension name is supported with all uppercase letters and maximum length of 30 characters. "ignoreNull": True or False, # Optional. Rows with null values will automatically fail a rule, unless ignore_null is true. In that case, such null rows are trivially considered passing.This field is only valid for the following type of rules: RangeExpectation RegexExpectation SetExpectation UniquenessExpectation diff --git a/docs/dyn/dataplex_v1.projects.locations.html b/docs/dyn/dataplex_v1.projects.locations.html index 12230093ce4..92448e990d3 100644 --- a/docs/dyn/dataplex_v1.projects.locations.html +++ b/docs/dyn/dataplex_v1.projects.locations.html @@ -169,6 +169,12 @@

Instance Methods

lookupEntry(name, aspectTypes=None, entry=None, paths=None, view=None, x__xgafv=None)

Looks up an entry by name using the permission on the source system.

+

+ lookupEntryLinks(name, entry=None, entryLinkTypes=None, entryMode=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Looks up Entry Links referencing the specified Entry.

+

+ lookupEntryLinks_next()

+

Retrieves the next page of results.

searchEntries(name, orderBy=None, pageSize=None, pageToken=None, query=None, scope=None, semanticSearch=None, x__xgafv=None)

Searches for Entries matching the given query and scope.

@@ -327,6 +333,63 @@

Method Details

}
+
+ lookupEntryLinks(name, entry=None, entryLinkTypes=None, entryMode=None, pageSize=None, pageToken=None, x__xgafv=None) +
Looks up Entry Links referencing the specified Entry.
+
+Args:
+  name: string, Required. The project to which the request should be attributed to Format: projects/{project_id_or_number}/locations/{location_id}. (required)
+  entry: string, Required. The resource name of the referred Entry. Format: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}. Entry Links which references this entry will be returned in the response.
+  entryLinkTypes: string, Entry link types to filter the response by. If empty, all entry link types will be returned. At most 10 entry link types can be specified. (repeated)
+  entryMode: string, Mode of entry reference.
+    Allowed values
+      ENTRY_MODE_UNSPECIFIED - Unspecified entry mode. Returns both directional and non-directional entry links which references the entry.
+      SOURCE - Returns all directed entry links which references the entry as source.
+      TARGET - Return all directed entry links which references the entry as target.
+  pageSize: integer, Maximum number of EntryLinks to return. The service may return fewer than this value. If unspecified, at most 10 EntryLinks will be returned. The maximum value is 10; values above 10 will be coerced to 10.
+  pageToken: string, Page token received from a previous LookupEntryLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters that are provided to the LookupEntryLinks request must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for LookupEntryLinks.
+  "entryLinks": [ # List of entry links that reference the specified entry.
+    { # EntryLink represents a link between two Entries.
+      "createTime": "A String", # Output only. The time when the Entry Link was created.
+      "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+      "entryReferences": [ # Required. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+        { # Reference to the Entry that is linked through the Entry Link.
+          "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+          "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+          "type": "A String", # Required. Immutable. The reference type of the Entry.
+        },
+      ],
+      "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+      "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+    },
+  ],
+  "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
+}
+
+ +
+ lookupEntryLinks_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+
searchEntries(name, orderBy=None, pageSize=None, pageToken=None, query=None, scope=None, semanticSearch=None, x__xgafv=None)
Searches for Entries matching the given query and scope.
diff --git a/googleapiclient/discovery_cache/documents/dataplex.v1.json b/googleapiclient/discovery_cache/documents/dataplex.v1.json
index e9c5293adea..5a534eed2a9 100644
--- a/googleapiclient/discovery_cache/documents/dataplex.v1.json
+++ b/googleapiclient/discovery_cache/documents/dataplex.v1.json
@@ -884,6 +884,68 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"lookupEntryLinks": {
+"description": "Looks up Entry Links referencing the specified Entry.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}:lookupEntryLinks",
+"httpMethod": "GET",
+"id": "dataplex.projects.locations.lookupEntryLinks",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"entry": {
+"description": "Required. The resource name of the referred Entry. Format: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}. Entry Links which references this entry will be returned in the response.",
+"location": "query",
+"type": "string"
+},
+"entryLinkTypes": {
+"description": "Entry link types to filter the response by. If empty, all entry link types will be returned. At most 10 entry link types can be specified.",
+"location": "query",
+"repeated": true,
+"type": "string"
+},
+"entryMode": {
+"description": "Mode of entry reference.",
+"enum": [
+"ENTRY_MODE_UNSPECIFIED",
+"SOURCE",
+"TARGET"
+],
+"enumDescriptions": [
+"Unspecified entry mode. Returns both directional and non-directional entry links which references the entry.",
+"Returns all directed entry links which references the entry as source.",
+"Return all directed entry links which references the entry as target."
+],
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The project to which the request should be attributed to Format: projects/{project_id_or_number}/locations/{location_id}.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+},
+"pageSize": {
+"description": "Maximum number of EntryLinks to return. The service may return fewer than this value. If unspecified, at most 10 EntryLinks will be returned. The maximum value is 10; values above 10 will be coerced to 10.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Page token received from a previous LookupEntryLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters that are provided to the LookupEntryLinks request must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}:lookupEntryLinks",
+"response": {
+"$ref": "GoogleCloudDataplexV1LookupEntryLinksResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "searchEntries": {
 "description": "Searches for Entries matching the given query and scope.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchEntries",
@@ -7869,7 +7931,7 @@
 }
 }
 },
-"revision": "20260203",
+"revision": "20260213",
 "rootUrl": "https://dataplex.googleapis.com/",
 "schemas": {
 "Empty": {
@@ -10114,6 +10176,13 @@
 "description": "Optional. The unnested column which this rule is evaluated against.",
 "type": "string"
 },
+"debugQueries": {
+"description": "Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future.",
+"items": {
+"$ref": "GoogleCloudDataplexV1DataQualityRuleDebugQuery"
+},
+"type": "array"
+},
 "description": {
 "description": "Optional. Description of the rule. The maximum length is 1,024 characters.",
 "type": "string"
@@ -10178,6 +10247,21 @@
 },
 "type": "object"
 },
+"GoogleCloudDataplexV1DataQualityRuleDebugQuery": {
+"description": "Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()}",
+"id": "GoogleCloudDataplexV1DataQualityRuleDebugQuery",
+"properties": {
+"description": {
+"description": "Optional. Specifies the description of the debug query. The maximum length is 1,024 characters.",
+"type": "string"
+},
+"sqlStatement": {
+"description": "Required. Specifies the SQL statement to be executed.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDataplexV1DataQualityRuleNonNullExpectation": {
 "description": "Evaluates whether each column value is null.",
 "id": "GoogleCloudDataplexV1DataQualityRuleNonNullExpectation",
@@ -10228,6 +10312,14 @@
 "readOnly": true,
 "type": "string"
 },
+"debugQueriesResultSets": {
+"description": "Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries.",
+"items": {
+"$ref": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet"
+},
+"readOnly": true,
+"type": "array"
+},
 "evaluatedCount": {
 "description": "Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion.",
 "format": "int64",
@@ -10270,6 +10362,40 @@
 },
 "type": "object"
 },
+"GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult": {
+"description": "Contains a single result from the debug query.",
+"id": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult",
+"properties": {
+"name": {
+"description": "Specifies the name of the result. Available if provided with an explicit alias using [AS] alias.",
+"type": "string"
+},
+"type": {
+"description": "Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types).",
+"type": "string"
+},
+"value": {
+"description": "Represents the value of the result as a string.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet": {
+"description": "Contains all results from a debug query.",
+"id": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet",
+"properties": {
+"results": {
+"description": "Output only. Contains all results. Up to 10 results can be returned.",
+"items": {
+"$ref": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudDataplexV1DataQualityRuleRowConditionExpectation": {
 "description": "Evaluates whether each row passes the specified condition.The SQL expression needs to use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax) and should produce a boolean value per row as the result.Example: col1 >= 0 AND col2 < 10",
 "id": "GoogleCloudDataplexV1DataQualityRuleRowConditionExpectation",
@@ -13458,6 +13584,24 @@
 },
 "type": "object"
 },
+"GoogleCloudDataplexV1LookupEntryLinksResponse": {
+"description": "Response message for LookupEntryLinks.",
+"id": "GoogleCloudDataplexV1LookupEntryLinksResponse",
+"properties": {
+"entryLinks": {
+"description": "List of entry links that reference the specified entry.",
+"items": {
+"$ref": "GoogleCloudDataplexV1EntryLink"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "Token to retrieve the next page of results, or empty if there are no more results in the list.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDataplexV1MetadataFeed": {
 "description": "MetadataFeed contains information related to the metadata feed.",
 "id": "GoogleCloudDataplexV1MetadataFeed",

From 11228ab21add546a6783e1f49b75d0a19163daf8 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 24 Feb 2026 07:27:56 +0000
Subject: [PATCH 10/29] feat(dialogflow): update the api

#### dialogflow:v2beta1

The following keys were added:
- schemas.GoogleCloudDialogflowV2beta1ConversationProfile.properties.useBidiStreaming.type (Total Keys: 1)
---
 .../dialogflow_v2beta1.projects.conversationProfiles.html   | 6 ++++++
 ...low_v2beta1.projects.locations.conversationProfiles.html | 6 ++++++
 .../dialogflow_v2beta1.projects.locations.suggestions.html  | 1 +
 docs/dyn/dialogflow_v2beta1.projects.suggestions.html       | 1 +
 .../discovery_cache/documents/dialogflow.v2beta1.json       | 5 ++++-
 5 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html b/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html
index 36fefd4cd37..36366d41ae4 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html
@@ -385,6 +385,7 @@ 

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } x__xgafv: string, V1 error format. @@ -621,6 +622,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, }
@@ -882,6 +884,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } @@ -1129,6 +1132,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, }, ], "nextPageToken": "A String", @@ -1384,6 +1388,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } updateMask: string, A parameter @@ -1621,6 +1626,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html index af1faa0da6c..9a4b9bc54ed 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html @@ -385,6 +385,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } x__xgafv: string, V1 error format. @@ -621,6 +622,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } @@ -882,6 +884,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } @@ -1129,6 +1132,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, }, ], "nextPageToken": "A String", @@ -1384,6 +1388,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } updateMask: string, A parameter @@ -1621,6 +1626,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, } diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html b/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html index 743a789eb9c..bed1d493e22 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html +++ b/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html @@ -325,6 +325,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, }, "latestMessage": "A String", "maxContextSize": 42, diff --git a/docs/dyn/dialogflow_v2beta1.projects.suggestions.html b/docs/dyn/dialogflow_v2beta1.projects.suggestions.html index 0cc37d3e2a4..dd709997a9c 100644 --- a/docs/dyn/dialogflow_v2beta1.projects.suggestions.html +++ b/docs/dyn/dialogflow_v2beta1.projects.suggestions.html @@ -325,6 +325,7 @@

Method Details

"volumeGainDb": 3.14, }, "updateTime": "A String", + "useBidiStreaming": True or False, }, "latestMessage": "A String", "maxContextSize": 42, diff --git a/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json b/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json index eff35347ed0..51157ed10e4 100644 --- a/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json +++ b/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json @@ -8431,7 +8431,7 @@ } } }, -"revision": "20260119", +"revision": "20260216", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -16463,6 +16463,9 @@ true "format": "google-datetime", "readOnly": true, "type": "string" +}, +"useBidiStreaming": { +"type": "boolean" } }, "type": "object" From 62871b0946a34cdb6414b76ddb796d45f87242e8 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:56 +0000 Subject: [PATCH 11/29] feat(discoveryengine): update the api #### discoveryengine:v1 The following keys were added: - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.methods.getCard (Total Keys: 11) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.message.methods.send (Total Keys: 12) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.message.methods.stream (Total Keys: 12) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.tasks.methods.cancel (Total Keys: 16) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.tasks.methods.get (Total Keys: 18) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.tasks.methods.subscribe (Total Keys: 15) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.tasks.resources.pushNotificationConfigs.methods.create (Total Keys: 18) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.tasks.resources.pushNotificationConfigs.methods.delete (Total Keys: 15) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.tasks.resources.pushNotificationConfigs.methods.get (Total Keys: 15) - resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.tasks.resources.pushNotificationConfigs.methods.list (Total Keys: 20) - schemas.A2aV1APIKeySecurityScheme (Total Keys: 4) - schemas.A2aV1AgentCapabilities (Total Keys: 6) - schemas.A2aV1AgentCard (Total Keys: 29) - schemas.A2aV1AgentExtension (Total Keys: 6) - schemas.A2aV1AgentInterface (Total Keys: 4) - schemas.A2aV1AgentProvider (Total Keys: 3) - schemas.A2aV1AgentSkill (Total Keys: 14) - schemas.A2aV1Artifact (Total Keys: 10) - schemas.A2aV1AuthenticationInfo (Total Keys: 5) - schemas.A2aV1AuthorizationCodeOAuthFlow (Total Keys: 4) - schemas.A2aV1CancelTaskRequest (Total Keys: 2) - schemas.A2aV1ClientCredentialsOAuthFlow (Total Keys: 4) - schemas.A2aV1DataPart (Total Keys: 4) - schemas.A2aV1FilePart (Total Keys: 7) - schemas.A2aV1HTTPAuthSecurityScheme (Total Keys: 4) - schemas.A2aV1ImplicitOAuthFlow (Total Keys: 4) - schemas.A2aV1ListTaskPushNotificationConfigResponse (Total Keys: 5) - schemas.A2aV1Message (Total Keys: 12) - schemas.A2aV1MutualTlsSecurityScheme (Total Keys: 2) - schemas.A2aV1OAuth2SecurityScheme (Total Keys: 3) - schemas.A2aV1OAuthFlows (Total Keys: 6) - schemas.A2aV1OpenIdConnectSecurityScheme (Total Keys: 2) - schemas.A2aV1Part (Total Keys: 7) - schemas.A2aV1PasswordOAuthFlow (Total Keys: 4) - schemas.A2aV1PushNotificationConfig (Total Keys: 5) - schemas.A2aV1Security (Total Keys: 11) - schemas.A2aV1SendMessageConfiguration (Total Keys: 8) - schemas.A2aV1SendMessageRequest (Total Keys: 6) - schemas.A2aV1SendMessageResponse (Total Keys: 4) - schemas.A2aV1StreamResponse (Total Keys: 6) - schemas.A2aV1StringList (Total Keys: 4) - schemas.A2aV1Task (Total Keys: 38) - schemas.GoogleCloudDiscoveryengineV1Engine.properties.connectorTenantInfo (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1alphaEngine.properties.connectorTenantInfo (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1betaEngine.properties.connectorTenantInfo (Total Keys: 2) #### discoveryengine:v1alpha The following keys were added: - schemas.GoogleCloudDiscoveryengineV1Engine.properties.connectorTenantInfo (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1alphaEngine.properties.connectorTenantInfo (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1betaEngine.properties.connectorTenantInfo (Total Keys: 2) #### discoveryengine:v1beta The following keys were added: - schemas.GoogleCloudDiscoveryengineV1Engine.properties.connectorTenantInfo (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1alphaEngine.properties.connectorTenantInfo (Total Keys: 2) - schemas.GoogleCloudDiscoveryengineV1betaEngine.properties.connectorTenantInfo (Total Keys: 2) --- ...collections.engines.assistants.agents.html | 177 ++ ...ons.engines.assistants.agents.message.html | 602 ++++++ ...tions.engines.assistants.agents.tasks.html | 594 ++++++ ....agents.tasks.pushNotificationConfigs.html | 253 +++ ...rojects.locations.collections.engines.html | 15 + ...collections.dataStores.servingConfigs.html | 4 +- ...rojects.locations.collections.engines.html | 21 + ...ns.collections.engines.servingConfigs.html | 4 +- ...s.locations.dataStores.servingConfigs.html | 4 +- ...1alpha.projects.locations.evaluations.html | 6 +- ...collections.dataStores.servingConfigs.html | 4 +- ...rojects.locations.collections.engines.html | 21 + ...ns.collections.engines.servingConfigs.html | 4 +- ...s.locations.dataStores.servingConfigs.html | 4 +- ...v1beta.projects.locations.evaluations.html | 6 +- .../documents/discoveryengine.v1.json | 1699 +++++++++++++++-- .../documents/discoveryengine.v1alpha.json | 63 +- .../documents/discoveryengine.v1beta.json | 57 +- 18 files changed, 3312 insertions(+), 226 deletions(-) create mode 100644 docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.message.html create mode 100644 docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.html create mode 100644 docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.html diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.html index 8ecdcad6442..a918de04069 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.html @@ -74,18 +74,195 @@

Discovery Engine API . projects . locations . collections . engines . assistants . agents

Instance Methods

+

+ message() +

+

Returns the message Resource.

+

operations()

Returns the operations Resource.

+

+ tasks() +

+

Returns the tasks Resource.

+

close()

Close httplib2 connections.

+

+ getCard(tenant, x__xgafv=None)

+

GetAgentCard returns the agent card for the agent.

Method Details

close()
Close httplib2 connections.
+
+ getCard(tenant, x__xgafv=None) +
GetAgentCard returns the agent card for the agent.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # AgentCard conveys key information: - Overall details (version, name, description, uses) - Skills; a set of actions/solutions the agent can perform - Default modalities/content types supported by the agent. - Authentication requirements Next ID: 19
+  "additionalInterfaces": [ # Announcement of additional supported transports. Client can use any of the supported transports.
+    { # Defines additional transport information for the agent.
+      "tenant": "A String", # Tenant to be set in the request when calling the agent. Experimental, might still change for 1.0 release.
+      "transport": "A String", # The transport supported this url. This is an open form string, to be easily extended for many transport protocols. The core ones officially supported are JSONRPC, GRPC and HTTP+JSON.
+      "url": "A String", # The url this interface is found at.
+    },
+  ],
+  "capabilities": { # Defines the A2A feature set supported by the agent # A2A Capability set supported by the agent.
+    "extensions": [ # Extensions supported by this agent.
+      { # A declaration of an extension supported by an Agent.
+        "description": "A String", # A description of how this agent uses this extension. Example: "Google OAuth 2.0 authentication"
+        "params": { # Optional configuration for the extension.
+          "a_key": "", # Properties of the object.
+        },
+        "required": True or False, # Whether the client must follow specific requirements of the extension. Example: false
+        "uri": "A String", # The URI of the extension. Example: "https://developers.google.com/identity/protocols/oauth2"
+      },
+    ],
+    "pushNotifications": True or False, # If the agent can send push notifications to the clients webhook
+    "streaming": True or False, # If the agent will support streaming responses
+  },
+  "defaultInputModes": [ # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED The set of interaction modes that the agent supports across all skills. This can be overridden per skill. Defined as mime types.
+    "A String",
+  ],
+  "defaultOutputModes": [ # The mime types supported as outputs from this agent.
+    "A String",
+  ],
+  "description": "A String", # A description of the agent's domain of action/solution space. Example: "Agent that helps users with recipes and cooking."
+  "documentationUrl": "A String", # A url to provide additional documentation about the agent.
+  "iconUrl": "A String", # An optional URL to an icon for the agent.
+  "name": "A String", # A human readable name for the agent. Example: "Recipe Agent"
+  "preferredTransport": "A String", # The transport of the preferred endpoint. If empty, defaults to JSONRPC.
+  "protocolVersion": "A String", # The version of the A2A protocol this agent supports.
+  "provider": { # Represents information about the service provider of an agent. # The service provider of the agent.
+    "organization": "A String", # The providers organization name Example: "Google"
+    "url": "A String", # The providers reference url Example: "https://ai.google.dev"
+  },
+  "security": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security requirements for contacting the agent. This list can be seen as an OR of ANDs. Each object in the list describes one possible set of security requirements that must be present on a request. This allows specifying, for example, "callers must either use OAuth OR an API Key AND mTLS." Example: security { schemes { key: "oauth" value { list: ["read"] } } } security { schemes { key: "api-key" } schemes { key: "mtls" } }
+    {
+      "schemes": {
+        "a_key": { # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+          "list": [
+            "A String",
+          ],
+        },
+      },
+    },
+  ],
+  "securitySchemes": { # The security scheme details used for authenticating with this agent.
+    "a_key": {
+      "apiKeySecurityScheme": {
+        "description": "A String", # Description of this security scheme.
+        "location": "A String", # Location of the API key, valid values are "query", "header", or "cookie"
+        "name": "A String", # Name of the header, query or cookie parameter to be used.
+      },
+      "httpAuthSecurityScheme": {
+        "bearerFormat": "A String", # A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
+        "description": "A String", # Description of this security scheme.
+        "scheme": "A String", # The name of the HTTP Authentication scheme to be used in the Authorization header as defined in RFC7235. The values used SHOULD be registered in the IANA Authentication Scheme registry. The value is case-insensitive, as defined in RFC7235.
+      },
+      "mtlsSecurityScheme": {
+        "description": "A String", # Description of this security scheme.
+      },
+      "oauth2SecurityScheme": {
+        "description": "A String", # Description of this security scheme.
+        "flows": { # An object containing configuration information for the flow types supported
+          "authorizationCode": {
+            "authorizationUrl": "A String", # The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS
+            "refreshUrl": "A String", # The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
+            "scopes": { # The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
+              "a_key": "A String",
+            },
+            "tokenUrl": "A String", # The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
+          },
+          "clientCredentials": {
+            "refreshUrl": "A String", # The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
+            "scopes": { # The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
+              "a_key": "A String",
+            },
+            "tokenUrl": "A String", # The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
+          },
+          "implicit": {
+            "authorizationUrl": "A String", # The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS
+            "refreshUrl": "A String", # The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
+            "scopes": { # The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
+              "a_key": "A String",
+            },
+          },
+          "password": {
+            "refreshUrl": "A String", # The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
+            "scopes": { # The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
+              "a_key": "A String",
+            },
+            "tokenUrl": "A String", # The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
+          },
+        },
+        "oauth2MetadataUrl": "A String", # URL to the oauth2 authorization server metadata [RFC8414](https://datatracker.ietf.org/doc/html/rfc8414). TLS is required.
+      },
+      "openIdConnectSecurityScheme": {
+        "description": "A String", # Description of this security scheme.
+        "openIdConnectUrl": "A String", # Well-known URL to discover the [[OpenID-Connect-Discovery]] provider metadata.
+      },
+    },
+  },
+  "signatures": [ # JSON Web Signatures computed for this AgentCard.
+    { # AgentCardSignature represents a JWS signature of an AgentCard. This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).
+      "header": { # The unprotected JWS header values.
+        "a_key": "", # Properties of the object.
+      },
+      "protected": "A String", # Required. The protected JWS header for the signature. This is always a base64url-encoded JSON object. Required.
+      "signature": "A String", # Required. The computed signature, base64url-encoded. Required.
+    },
+  ],
+  "skills": [ # Skills represent a unit of ability an agent can perform. This may somewhat abstract but represents a more focused set of actions that the agent is highly likely to succeed at.
+    { # AgentSkill represents a unit of action/solution that the agent can perform. One can think of this as a type of highly reliable solution that an agent can be tasked to provide. Agents have the autonomy to choose how and when to use specific skills, but clients should have confidence that if the skill is defined that unit of action can be reliably performed.
+      "description": "A String", # A human (or llm) readable description of the skill details and behaviors.
+      "examples": [ # A set of example queries that this skill is designed to address. These examples should help the caller to understand how to craft requests to the agent to achieve specific goals. Example: ["I need a recipe for bread"]
+        "A String",
+      ],
+      "id": "A String", # Unique identifier of the skill within this agent.
+      "inputModes": [ # Possible input modalities supported.
+        "A String",
+      ],
+      "name": "A String", # A human readable name for the skill.
+      "outputModes": [ # Possible output modalities produced
+        "A String",
+      ],
+      "security": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security schemes necessary for the agent to leverage this skill. As in the overall AgentCard.security, this list represents a logical OR of security requirement objects. Each object is a set of security schemes that must be used together (a logical AND). protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
+        {
+          "schemes": {
+            "a_key": { # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+              "list": [
+                "A String",
+              ],
+            },
+          },
+        },
+      ],
+      "tags": [ # A set of tags for the skill to enhance categorization/utilization. Example: ["cooking", "customer support", "billing"]
+        "A String",
+      ],
+    },
+  ],
+  "supportsAuthenticatedExtendedCard": True or False, # Whether the agent supports providing an extended agent card when the user is authenticated, i.e. is the card from .well-known different than the card from GetAgentCard.
+  "url": "A String", # A URL to the address the agent is hosted at. This represents the preferred endpoint as declared by the agent.
+  "version": "A String", # The version of the agent. Example: "1.0.0"
+}
+
+ \ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.message.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.message.html new file mode 100644 index 00000000000..be799b28311 --- /dev/null +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.message.html @@ -0,0 +1,602 @@ + + + +

Discovery Engine API . projects . locations . collections . engines . assistants . agents . message

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ send(tenant, body=None, x__xgafv=None)

+

Send a message to the agent. This is a blocking call that will return the task once it is completed, or a LRO if requested.

+

+ stream(tenant, body=None, x__xgafv=None)

+

SendStreamingMessage is a streaming call that will return a stream of task update events until the Task is in an interrupted or terminal state.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ send(tenant, body=None, x__xgafv=None) +
Send a message to the agent. This is a blocking call that will return the task once it is completed, or a LRO if requested.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # /////////// Request Messages ///////////
+  "configuration": { # Configuration of a send message request. # Configuration for the send request.
+    "acceptedOutputModes": [ # The output modes that the agent is expected to respond with.
+      "A String",
+    ],
+    "blocking": True or False, # If true, the message will be blocking until the task is completed. If false, the message will be non-blocking and the task will be returned immediately. It is the caller's responsibility to check for any task updates.
+    "historyLength": 42, # The maximum number of messages to include in the history. if 0, the history will be unlimited.
+    "pushNotification": { # Configuration for setting up push notifications for task updates. # A configuration of a webhook that can be used to receive updates
+      "authentication": { # Defines authentication details, used for push notifications. # Information about the authentication to sent with the notification
+        "credentials": "A String", # Optional credentials
+        "schemes": [ # Supported authentication schemes - e.g. Basic, Bearer, etc
+          "A String",
+        ],
+      },
+      "id": "A String", # A unique identifier (e.g. UUID) for this push notification.
+      "token": "A String", # Token unique for this task/session
+      "url": "A String", # Url to send the notification too
+    },
+  },
+  "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # Required. The message to send to the agent.
+    "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+      { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+        "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+          "data": {
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+          "fileWithBytes": "A String",
+          "fileWithUri": "A String",
+          "mimeType": "A String",
+          "name": "A String",
+        },
+        "metadata": { # Optional metadata associated with this part.
+          "a_key": "", # Properties of the object.
+        },
+        "text": "A String",
+      },
+    ],
+    "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+    "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+      "A String",
+    ],
+    "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+      "a_key": "", # Properties of the object.
+    },
+    "role": "A String", # A role for the message.
+    "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+  },
+  "metadata": { # Optional metadata for the request.
+    "a_key": "", # Properties of the object.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # ////// Response Messages ///////////
+  "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+    "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+      { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+        "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+          "data": {
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+          "fileWithBytes": "A String",
+          "fileWithUri": "A String",
+          "mimeType": "A String",
+          "name": "A String",
+        },
+        "metadata": { # Optional metadata associated with this part.
+          "a_key": "", # Properties of the object.
+        },
+        "text": "A String",
+      },
+    ],
+    "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+    "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+      "A String",
+    ],
+    "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+      "a_key": "", # Properties of the object.
+    },
+    "role": "A String", # A role for the message.
+    "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+  },
+  "task": { # Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.
+    "artifacts": [ # A set of output artifacts for a Task.
+      { # Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.
+        "artifactId": "A String", # Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.
+        "description": "A String", # A human readable description of the artifact, optional.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Artifact.
+          "A String",
+        ],
+        "metadata": { # Optional metadata included with the artifact.
+          "a_key": "", # Properties of the object.
+        },
+        "name": "A String", # A human readable name for the artifact.
+        "parts": [ # The content of the artifact.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+      },
+    ],
+    "contextId": "A String", # Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.
+    "history": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.
+      { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+    ],
+    "id": "A String", # Unique identifier (e.g. UUID) for the task, generated by the server for a new task.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.
+      "a_key": "", # Properties of the object.
+    },
+    "status": { # A container for the status of a task # The current status of a Task, including state and a message.
+      "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # A message associated with the status.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+      "state": "A String", # The current state of this task
+      "timestamp": "A String", # Timestamp when the status was recorded. Example: "2023-10-27T10:00:00Z"
+    },
+  },
+}
+
+ +
+ stream(tenant, body=None, x__xgafv=None) +
SendStreamingMessage is a streaming call that will return a stream of task update events until the Task is in an interrupted or terminal state.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # /////////// Request Messages ///////////
+  "configuration": { # Configuration of a send message request. # Configuration for the send request.
+    "acceptedOutputModes": [ # The output modes that the agent is expected to respond with.
+      "A String",
+    ],
+    "blocking": True or False, # If true, the message will be blocking until the task is completed. If false, the message will be non-blocking and the task will be returned immediately. It is the caller's responsibility to check for any task updates.
+    "historyLength": 42, # The maximum number of messages to include in the history. if 0, the history will be unlimited.
+    "pushNotification": { # Configuration for setting up push notifications for task updates. # A configuration of a webhook that can be used to receive updates
+      "authentication": { # Defines authentication details, used for push notifications. # Information about the authentication to sent with the notification
+        "credentials": "A String", # Optional credentials
+        "schemes": [ # Supported authentication schemes - e.g. Basic, Bearer, etc
+          "A String",
+        ],
+      },
+      "id": "A String", # A unique identifier (e.g. UUID) for this push notification.
+      "token": "A String", # Token unique for this task/session
+      "url": "A String", # Url to send the notification too
+    },
+  },
+  "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # Required. The message to send to the agent.
+    "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+      { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+        "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+          "data": {
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+          "fileWithBytes": "A String",
+          "fileWithUri": "A String",
+          "mimeType": "A String",
+          "name": "A String",
+        },
+        "metadata": { # Optional metadata associated with this part.
+          "a_key": "", # Properties of the object.
+        },
+        "text": "A String",
+      },
+    ],
+    "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+    "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+      "A String",
+    ],
+    "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+      "a_key": "", # Properties of the object.
+    },
+    "role": "A String", # A role for the message.
+    "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+  },
+  "metadata": { # Optional metadata for the request.
+    "a_key": "", # Properties of the object.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The stream response for a message. The stream should be one of the following sequences: If the response is a message, the stream should contain one, and only one, message and then close If the response is a task lifecycle, the first response should be a Task object followed by zero or more TaskStatusUpdateEvents and TaskArtifactUpdateEvents. The stream should complete when the Task if in an interrupted or terminal state. A stream that ends before these conditions are met are
+  "artifactUpdate": { # TaskArtifactUpdateEvent represents a task delta where an artifact has been generated.
+    "append": True or False, # Whether this should be appended to a prior one produced
+    "artifact": { # Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication. # The artifact itself
+      "artifactId": "A String", # Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.
+      "description": "A String", # A human readable description of the artifact, optional.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Artifact.
+        "A String",
+      ],
+      "metadata": { # Optional metadata included with the artifact.
+        "a_key": "", # Properties of the object.
+      },
+      "name": "A String", # A human readable name for the artifact.
+      "parts": [ # The content of the artifact.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+    },
+    "contextId": "A String", # The id of the context that this task belongs too
+    "lastChunk": True or False, # Whether this represents the last part of an artifact
+    "metadata": { # Optional metadata associated with the artifact update.
+      "a_key": "", # Properties of the object.
+    },
+    "taskId": "A String", # The id of the task for this artifact
+  },
+  "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+    "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+      { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+        "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+          "data": {
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+          "fileWithBytes": "A String",
+          "fileWithUri": "A String",
+          "mimeType": "A String",
+          "name": "A String",
+        },
+        "metadata": { # Optional metadata associated with this part.
+          "a_key": "", # Properties of the object.
+        },
+        "text": "A String",
+      },
+    ],
+    "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+    "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+      "A String",
+    ],
+    "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+      "a_key": "", # Properties of the object.
+    },
+    "role": "A String", # A role for the message.
+    "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+  },
+  "statusUpdate": { # TaskStatusUpdateEvent is a delta even on a task indicating that a task has changed.
+    "contextId": "A String", # The id of the context that the task belongs to
+    "final": True or False, # Whether this is the last status update expected for this task.
+    "metadata": { # Optional metadata to associate with the task update.
+      "a_key": "", # Properties of the object.
+    },
+    "status": { # A container for the status of a task # The new status of the task.
+      "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # A message associated with the status.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+      "state": "A String", # The current state of this task
+      "timestamp": "A String", # Timestamp when the status was recorded. Example: "2023-10-27T10:00:00Z"
+    },
+    "taskId": "A String", # The id of the task that is changed
+  },
+  "task": { # Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.
+    "artifacts": [ # A set of output artifacts for a Task.
+      { # Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.
+        "artifactId": "A String", # Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.
+        "description": "A String", # A human readable description of the artifact, optional.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Artifact.
+          "A String",
+        ],
+        "metadata": { # Optional metadata included with the artifact.
+          "a_key": "", # Properties of the object.
+        },
+        "name": "A String", # A human readable name for the artifact.
+        "parts": [ # The content of the artifact.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+      },
+    ],
+    "contextId": "A String", # Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.
+    "history": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.
+      { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+    ],
+    "id": "A String", # Unique identifier (e.g. UUID) for the task, generated by the server for a new task.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.
+      "a_key": "", # Properties of the object.
+    },
+    "status": { # A container for the status of a task # The current status of a Task, including state and a message.
+      "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # A message associated with the status.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+      "state": "A String", # The current state of this task
+      "timestamp": "A String", # Timestamp when the status was recorded. Example: "2023-10-27T10:00:00Z"
+    },
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.html new file mode 100644 index 00000000000..9066c71def1 --- /dev/null +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.html @@ -0,0 +1,594 @@ + + + +

Discovery Engine API . projects . locations . collections . engines . assistants . agents . tasks

+

Instance Methods

+

+ pushNotificationConfigs() +

+

Returns the pushNotificationConfigs Resource.

+ +

+ cancel(tenant, name, body=None, x__xgafv=None)

+

Cancel a task from the agent. If supported one should expect no more task updates for the task.

+

+ close()

+

Close httplib2 connections.

+

+ get(tenant, name, historyLength=None, x__xgafv=None)

+

Get the current state of a task from the agent.

+

+ subscribe(tenant, name, x__xgafv=None)

+

TaskSubscription is a streaming call that will return a stream of task update events. This attaches the stream to an existing in process task. If the task is complete the stream will return the completed task (like GetTask) and close the stream.

+

Method Details

+
+ cancel(tenant, name, body=None, x__xgafv=None) +
Cancel a task from the agent. If supported one should expect no more task updates for the task.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  name: string, The resource name of the task to cancel. Format: tasks/{task_id} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.
+  "artifacts": [ # A set of output artifacts for a Task.
+    { # Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.
+      "artifactId": "A String", # Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.
+      "description": "A String", # A human readable description of the artifact, optional.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Artifact.
+        "A String",
+      ],
+      "metadata": { # Optional metadata included with the artifact.
+        "a_key": "", # Properties of the object.
+      },
+      "name": "A String", # A human readable name for the artifact.
+      "parts": [ # The content of the artifact.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+    },
+  ],
+  "contextId": "A String", # Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.
+  "history": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.
+    { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+      "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+      "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+        "A String",
+      ],
+      "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+      "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+        "a_key": "", # Properties of the object.
+      },
+      "role": "A String", # A role for the message.
+      "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+    },
+  ],
+  "id": "A String", # Unique identifier (e.g. UUID) for the task, generated by the server for a new task.
+  "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.
+    "a_key": "", # Properties of the object.
+  },
+  "status": { # A container for the status of a task # The current status of a Task, including state and a message.
+    "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # A message associated with the status.
+      "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+      "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+        "A String",
+      ],
+      "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+      "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+        "a_key": "", # Properties of the object.
+      },
+      "role": "A String", # A role for the message.
+      "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+    },
+    "state": "A String", # The current state of this task
+    "timestamp": "A String", # Timestamp when the status was recorded. Example: "2023-10-27T10:00:00Z"
+  },
+}
+
+ +
+ close() +
Close httplib2 connections.
+
+ +
+ get(tenant, name, historyLength=None, x__xgafv=None) +
Get the current state of a task from the agent.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  name: string, Required. The resource name of the task. Format: tasks/{task_id} (required)
+  historyLength: integer, The number of most recent messages from the task's history to retrieve.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.
+  "artifacts": [ # A set of output artifacts for a Task.
+    { # Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.
+      "artifactId": "A String", # Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.
+      "description": "A String", # A human readable description of the artifact, optional.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Artifact.
+        "A String",
+      ],
+      "metadata": { # Optional metadata included with the artifact.
+        "a_key": "", # Properties of the object.
+      },
+      "name": "A String", # A human readable name for the artifact.
+      "parts": [ # The content of the artifact.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+    },
+  ],
+  "contextId": "A String", # Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.
+  "history": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.
+    { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+      "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+      "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+        "A String",
+      ],
+      "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+      "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+        "a_key": "", # Properties of the object.
+      },
+      "role": "A String", # A role for the message.
+      "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+    },
+  ],
+  "id": "A String", # Unique identifier (e.g. UUID) for the task, generated by the server for a new task.
+  "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.
+    "a_key": "", # Properties of the object.
+  },
+  "status": { # A container for the status of a task # The current status of a Task, including state and a message.
+    "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # A message associated with the status.
+      "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+      "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+        "A String",
+      ],
+      "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+      "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+        "a_key": "", # Properties of the object.
+      },
+      "role": "A String", # A role for the message.
+      "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+    },
+    "state": "A String", # The current state of this task
+    "timestamp": "A String", # Timestamp when the status was recorded. Example: "2023-10-27T10:00:00Z"
+  },
+}
+
+ +
+ subscribe(tenant, name, x__xgafv=None) +
TaskSubscription is a streaming call that will return a stream of task update events. This attaches the stream to an existing in process task. If the task is complete the stream will return the completed task (like GetTask) and close the stream.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  name: string, The resource name of the task to subscribe to. Format: tasks/{task_id} (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The stream response for a message. The stream should be one of the following sequences: If the response is a message, the stream should contain one, and only one, message and then close If the response is a task lifecycle, the first response should be a Task object followed by zero or more TaskStatusUpdateEvents and TaskArtifactUpdateEvents. The stream should complete when the Task if in an interrupted or terminal state. A stream that ends before these conditions are met are
+  "artifactUpdate": { # TaskArtifactUpdateEvent represents a task delta where an artifact has been generated.
+    "append": True or False, # Whether this should be appended to a prior one produced
+    "artifact": { # Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication. # The artifact itself
+      "artifactId": "A String", # Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.
+      "description": "A String", # A human readable description of the artifact, optional.
+      "extensions": [ # The URIs of extensions that are present or contributed to this Artifact.
+        "A String",
+      ],
+      "metadata": { # Optional metadata included with the artifact.
+        "a_key": "", # Properties of the object.
+      },
+      "name": "A String", # A human readable name for the artifact.
+      "parts": [ # The content of the artifact.
+        { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+          "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+            "data": {
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+            "fileWithBytes": "A String",
+            "fileWithUri": "A String",
+            "mimeType": "A String",
+            "name": "A String",
+          },
+          "metadata": { # Optional metadata associated with this part.
+            "a_key": "", # Properties of the object.
+          },
+          "text": "A String",
+        },
+      ],
+    },
+    "contextId": "A String", # The id of the context that this task belongs too
+    "lastChunk": True or False, # Whether this represents the last part of an artifact
+    "metadata": { # Optional metadata associated with the artifact update.
+      "a_key": "", # Properties of the object.
+    },
+    "taskId": "A String", # The id of the task for this artifact
+  },
+  "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+    "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+      { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+        "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+          "data": {
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+          "fileWithBytes": "A String",
+          "fileWithUri": "A String",
+          "mimeType": "A String",
+          "name": "A String",
+        },
+        "metadata": { # Optional metadata associated with this part.
+          "a_key": "", # Properties of the object.
+        },
+        "text": "A String",
+      },
+    ],
+    "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+    "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+      "A String",
+    ],
+    "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+      "a_key": "", # Properties of the object.
+    },
+    "role": "A String", # A role for the message.
+    "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+  },
+  "statusUpdate": { # TaskStatusUpdateEvent is a delta even on a task indicating that a task has changed.
+    "contextId": "A String", # The id of the context that the task belongs to
+    "final": True or False, # Whether this is the last status update expected for this task.
+    "metadata": { # Optional metadata to associate with the task update.
+      "a_key": "", # Properties of the object.
+    },
+    "status": { # A container for the status of a task # The new status of the task.
+      "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # A message associated with the status.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+      "state": "A String", # The current state of this task
+      "timestamp": "A String", # Timestamp when the status was recorded. Example: "2023-10-27T10:00:00Z"
+    },
+    "taskId": "A String", # The id of the task that is changed
+  },
+  "task": { # Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.
+    "artifacts": [ # A set of output artifacts for a Task.
+      { # Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.
+        "artifactId": "A String", # Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.
+        "description": "A String", # A human readable description of the artifact, optional.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Artifact.
+          "A String",
+        ],
+        "metadata": { # Optional metadata included with the artifact.
+          "a_key": "", # Properties of the object.
+        },
+        "name": "A String", # A human readable name for the artifact.
+        "parts": [ # The content of the artifact.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+      },
+    ],
+    "contextId": "A String", # Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.
+    "history": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.
+      { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+    ],
+    "id": "A String", # Unique identifier (e.g. UUID) for the task, generated by the server for a new task.
+    "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.
+      "a_key": "", # Properties of the object.
+    },
+    "status": { # A container for the status of a task # The current status of a Task, including state and a message.
+      "message": { # Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id. # A message associated with the status.
+        "content": [ # protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.
+          { # Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
+            "data": { # DataPart represents a structured blob. This is most commonly a JSON payload.
+              "data": {
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "file": { # FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.
+              "fileWithBytes": "A String",
+              "fileWithUri": "A String",
+              "mimeType": "A String",
+              "name": "A String",
+            },
+            "metadata": { # Optional metadata associated with this part.
+              "a_key": "", # Properties of the object.
+            },
+            "text": "A String",
+          },
+        ],
+        "contextId": "A String", # The context id of the message. This is optional and if set, the message will be associated with the given context.
+        "extensions": [ # The URIs of extensions that are present or contributed to this Message.
+          "A String",
+        ],
+        "messageId": "A String", # The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.
+        "metadata": { # protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.
+          "a_key": "", # Properties of the object.
+        },
+        "role": "A String", # A role for the message.
+        "taskId": "A String", # The task id of the message. This is optional and if set, the message will be associated with the given task.
+      },
+      "state": "A String", # The current state of this task
+      "timestamp": "A String", # Timestamp when the status was recorded. Example: "2023-10-27T10:00:00Z"
+    },
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.html new file mode 100644 index 00000000000..224e47e79d5 --- /dev/null +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.html @@ -0,0 +1,253 @@ + + + +

Discovery Engine API . projects . locations . collections . engines . assistants . agents . tasks . pushNotificationConfigs

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(tenant, parent, body=None, configId=None, x__xgafv=None)

+

Set a push notification config for a task.

+

+ delete(tenant, name, x__xgafv=None)

+

Delete a push notification config for a task.

+

+ get(tenant, name, x__xgafv=None)

+

Get a push notification config for a task.

+

+ list(tenant, parent, pageSize=None, pageToken=None, x__xgafv=None)

+

Get a list of push notifications configured for a task.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ create(tenant, parent, body=None, configId=None, x__xgafv=None) +
Set a push notification config for a task.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  parent: string, Required. The parent task resource for this config. Format: tasks/{task_id} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "name": "A String", # The resource name of the config. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
+  "pushNotificationConfig": { # Configuration for setting up push notifications for task updates. # The push notification configuration details.
+    "authentication": { # Defines authentication details, used for push notifications. # Information about the authentication to sent with the notification
+      "credentials": "A String", # Optional credentials
+      "schemes": [ # Supported authentication schemes - e.g. Basic, Bearer, etc
+        "A String",
+      ],
+    },
+    "id": "A String", # A unique identifier (e.g. UUID) for this push notification.
+    "token": "A String", # Token unique for this task/session
+    "url": "A String", # Url to send the notification too
+  },
+}
+
+  configId: string, Required. The ID for the new config.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "name": "A String", # The resource name of the config. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
+  "pushNotificationConfig": { # Configuration for setting up push notifications for task updates. # The push notification configuration details.
+    "authentication": { # Defines authentication details, used for push notifications. # Information about the authentication to sent with the notification
+      "credentials": "A String", # Optional credentials
+      "schemes": [ # Supported authentication schemes - e.g. Basic, Bearer, etc
+        "A String",
+      ],
+    },
+    "id": "A String", # A unique identifier (e.g. UUID) for this push notification.
+    "token": "A String", # Token unique for this task/session
+    "url": "A String", # Url to send the notification too
+  },
+}
+
+ +
+ delete(tenant, name, x__xgafv=None) +
Delete a push notification config for a task.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  name: string, The resource name of the config to delete. Format: tasks/{task_id}/pushNotificationConfigs/{config_id} (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
+}
+
+ +
+ get(tenant, name, x__xgafv=None) +
Get a push notification config for a task.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  name: string, The resource name of the config to retrieve. Format: tasks/{task_id}/pushNotificationConfigs/{config_id} (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "name": "A String", # The resource name of the config. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
+  "pushNotificationConfig": { # Configuration for setting up push notifications for task updates. # The push notification configuration details.
+    "authentication": { # Defines authentication details, used for push notifications. # Information about the authentication to sent with the notification
+      "credentials": "A String", # Optional credentials
+      "schemes": [ # Supported authentication schemes - e.g. Basic, Bearer, etc
+        "A String",
+      ],
+    },
+    "id": "A String", # A unique identifier (e.g. UUID) for this push notification.
+    "token": "A String", # Token unique for this task/session
+    "url": "A String", # Url to send the notification too
+  },
+}
+
+ +
+ list(tenant, parent, pageSize=None, pageToken=None, x__xgafv=None) +
Get a list of push notifications configured for a task.
+
+Args:
+  tenant: string, Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release. (required)
+  parent: string, The parent task resource. Format: tasks/{task_id} (required)
+  pageSize: integer, For AIP-158 these fields are present. Usually not used/needed. The maximum number of configurations to return. If unspecified, all configs will be returned.
+  pageToken: string, A page token received from a previous ListTaskPushNotificationConfigRequest call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTaskPushNotificationConfigRequest` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "configs": [ # The list of push notification configurations.
+    {
+      "name": "A String", # The resource name of the config. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
+      "pushNotificationConfig": { # Configuration for setting up push notifications for task updates. # The push notification configuration details.
+        "authentication": { # Defines authentication details, used for push notifications. # Information about the authentication to sent with the notification
+          "credentials": "A String", # Optional credentials
+          "schemes": [ # Supported authentication schemes - e.g. Basic, Bearer, etc
+            "A String",
+          ],
+        },
+        "id": "A String", # A unique identifier (e.g. UUID) for this push notification.
+        "token": "A String", # Token unique for this task/session
+        "url": "A String", # Url to send the notification too
+      },
+    },
+  ],
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ + \ No newline at end of file diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html index fedec100fc0..a5af7cde149 100644 --- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html +++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html @@ -189,6 +189,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -363,6 +366,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -513,6 +519,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -635,6 +644,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -739,6 +751,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html index 33e3ea3bd7a..f56e0ce49ef 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html @@ -1956,7 +1956,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -2604,7 +2604,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html index 9f595704b4f..fab9e24a450 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html @@ -206,6 +206,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -389,6 +392,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -567,6 +573,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -698,6 +707,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -811,6 +823,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -936,6 +951,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -1061,6 +1079,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html index d9ef8d2b654..dc7de193cd6 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html @@ -1956,7 +1956,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -2604,7 +2604,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html index 9c1a29f2eec..0d574f44233 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html @@ -1956,7 +1956,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -2604,7 +2604,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html index 16c68cff8b9..13c7b56c163 100644 --- a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html +++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html @@ -298,7 +298,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -627,7 +627,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -932,7 +932,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html index 4b6d4acd936..41498875b26 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html @@ -1837,7 +1837,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -2481,7 +2481,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html index 583909ebd2e..f551fae3288 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html @@ -193,6 +193,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -367,6 +370,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -517,6 +523,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -639,6 +648,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -743,6 +755,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -859,6 +874,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", @@ -975,6 +993,9 @@

Method Details

"companyName": "A String", # The name of the company, business or entity that is associated with the engine. Setting this may help improve LLM related features. }, "configurableBillingApproach": "A String", # Optional. Configuration for configurable billing approach. + "connectorTenantInfo": { # Optional. Maps a connector ID (e.g., "hybrid-github", "shopify") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent. + "a_key": "A String", + }, "createTime": "A String", # Output only. Timestamp the Recommendation Engine was created at. "dataStoreIds": [ # Optional. The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. "A String", diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html index dd6380d93e1..cf1a69e3107 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html @@ -1837,7 +1837,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -2481,7 +2481,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html index 3fcb721e0bb..6cd63c93a84 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html @@ -1837,7 +1837,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -2481,7 +2481,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html index 79aa3f97424..5a0cb19cf2f 100644 --- a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html +++ b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html @@ -295,7 +295,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -620,7 +620,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. @@ -921,7 +921,7 @@

Method Details

"A String", ], }, - "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit. + "numResultsPerDataStore": 42, # Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit. "offset": 42, # A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold. "oneBoxPageSize": 42, # The maximum number of results to return for OneBox. This applies to each OneBox type individually. Default number is 10. "orderBy": "A String", # The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering the website search results, see [Order web search results](https://cloud.google.com/generative-ai-app-builder/docs/order-web-search-results). For more information on ordering the healthcare search results, see [Order healthcare search results](https://cloud.google.com/generative-ai-app-builder/docs/order-hc-results). If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json index fcc5bf41c43..e927040359b 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json @@ -4022,7 +4022,94 @@ }, "resources": { "agents": { +"methods": { +"getCard": { +"description": "GetAgentCard returns the agent card for the agent.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/card", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.getCard", +"parameterOrder": [ +"tenant" +], +"parameters": { +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/card", +"response": { +"$ref": "A2aV1AgentCard" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +}, "resources": { +"message": { +"methods": { +"send": { +"description": "Send a message to the agent. This is a blocking call that will return the task once it is completed, or a LRO if requested.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/message:send", +"httpMethod": "POST", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.message.send", +"parameterOrder": [ +"tenant" +], +"parameters": { +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/message:send", +"request": { +"$ref": "A2aV1SendMessageRequest" +}, +"response": { +"$ref": "A2aV1SendMessageResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"stream": { +"description": "SendStreamingMessage is a streaming call that will return a stream of task update events until the Task is in an interrupted or terminal state.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/message:stream", +"httpMethod": "POST", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.message.stream", +"parameterOrder": [ +"tenant" +], +"parameters": { +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/message:stream", +"request": { +"$ref": "A2aV1SendMessageRequest" +}, +"response": { +"$ref": "A2aV1StreamResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +}, "operations": { "methods": { "get": { @@ -4052,6 +4139,275 @@ ] } } +}, +"tasks": { +"methods": { +"cancel": { +"description": "Cancel a task from the agent. If supported one should expect no more task updates for the task.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}:cancel", +"httpMethod": "POST", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.cancel", +"parameterOrder": [ +"tenant", +"name" +], +"parameters": { +"name": { +"description": "The resource name of the task to cancel. Format: tasks/{task_id}", +"location": "path", +"pattern": "^tasks/[^/]+$", +"required": true, +"type": "string" +}, +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/{+name}:cancel", +"request": { +"$ref": "A2aV1CancelTaskRequest" +}, +"response": { +"$ref": "A2aV1Task" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"get": { +"description": "Get the current state of a task from the agent.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.get", +"parameterOrder": [ +"tenant", +"name" +], +"parameters": { +"historyLength": { +"description": "The number of most recent messages from the task's history to retrieve.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"name": { +"description": "Required. The resource name of the task. Format: tasks/{task_id}", +"location": "path", +"pattern": "^tasks/[^/]+$", +"required": true, +"type": "string" +}, +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/{+name}", +"response": { +"$ref": "A2aV1Task" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"subscribe": { +"description": "TaskSubscription is a streaming call that will return a stream of task update events. This attaches the stream to an existing in process task. If the task is complete the stream will return the completed task (like GetTask) and close the stream.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}:subscribe", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.subscribe", +"parameterOrder": [ +"tenant", +"name" +], +"parameters": { +"name": { +"description": "The resource name of the task to subscribe to. Format: tasks/{task_id}", +"location": "path", +"pattern": "^tasks/[^/]+$", +"required": true, +"type": "string" +}, +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/{+name}:subscribe", +"response": { +"$ref": "A2aV1StreamResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +}, +"resources": { +"pushNotificationConfigs": { +"methods": { +"create": { +"description": "Set a push notification config for a task.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs", +"httpMethod": "POST", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.create", +"parameterOrder": [ +"tenant", +"parent" +], +"parameters": { +"configId": { +"description": "Required. The ID for the new config.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The parent task resource for this config. Format: tasks/{task_id}", +"location": "path", +"pattern": "^tasks/[^/]+/pushNotificationConfigs$", +"required": true, +"type": "string" +}, +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/{+parent}", +"request": { +"$ref": "A2aV1TaskPushNotificationConfig" +}, +"response": { +"$ref": "A2aV1TaskPushNotificationConfig" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"delete": { +"description": "Delete a push notification config for a task.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", +"httpMethod": "DELETE", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.delete", +"parameterOrder": [ +"tenant", +"name" +], +"parameters": { +"name": { +"description": "The resource name of the config to delete. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}", +"location": "path", +"pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$", +"required": true, +"type": "string" +}, +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/{+name}", +"response": { +"$ref": "GoogleProtobufEmpty" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"get": { +"description": "Get a push notification config for a task.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.get", +"parameterOrder": [ +"tenant", +"name" +], +"parameters": { +"name": { +"description": "The resource name of the config to retrieve. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}", +"location": "path", +"pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$", +"required": true, +"type": "string" +}, +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/{+name}", +"response": { +"$ref": "A2aV1TaskPushNotificationConfig" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"list": { +"description": "Get a list of push notifications configured for a task.", +"flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.list", +"parameterOrder": [ +"tenant", +"parent" +], +"parameters": { +"pageSize": { +"description": "For AIP-158 these fields are present. Usually not used/needed. The maximum number of configurations to return. If unspecified, all configs will be returned.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "A page token received from a previous ListTaskPushNotificationConfigRequest call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTaskPushNotificationConfigRequest` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "The parent task resource. Format: tasks/{task_id}", +"location": "path", +"pattern": "^tasks/[^/]+$", +"required": true, +"type": "string" +}, +"tenant": { +"description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "{+tenant}/{+parent}/pushNotificationConfigs", +"response": { +"$ref": "A2aV1ListTaskPushNotificationConfigResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +} +} } } } @@ -8652,219 +9008,1171 @@ "required": true, "type": "string" }, -"updateMask": { -"description": "Optional. The list of fields to update.", -"format": "google-fieldmask", -"location": "query", -"type": "string" +"updateMask": { +"description": "Optional. The list of fields to update.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "GoogleCloudDiscoveryengineV1UserStore" +}, +"response": { +"$ref": "GoogleCloudDiscoveryengineV1UserStore" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/discoveryengine.readwrite" +] +} +}, +"resources": { +"licenseConfigsUsageStats": { +"methods": { +"list": { +"description": "Lists all the LicenseConfigUsageStatss associated with the project.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/userStores/{userStoresId}/licenseConfigsUsageStats", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.userStores.licenseConfigsUsageStats.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/userStores/{user_store_id}`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/userStores/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/licenseConfigsUsageStats", +"response": { +"$ref": "GoogleCloudDiscoveryengineV1ListLicenseConfigsUsageStatsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/discoveryengine.readwrite" +] +} +} +}, +"userLicenses": { +"methods": { +"list": { +"description": "Lists the User Licenses.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/userStores/{userStoresId}/userLicenses", +"httpMethod": "GET", +"id": "discoveryengine.projects.locations.userStores.userLicenses.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"orderBy": { +"description": "Optional. The order in which the UserLicenses are listed. The value must be a comma-separated list of fields. Default sorting order is ascending. To specify descending order for a field, append a \" desc\" suffix. Redundant space characters in the syntax are insignificant. Supported fields: * `license_assignment_state` * `user_principal` * `user_profile` * `last_login_date` * `update_time` If not set, the default ordering is by `user_principal`. Examples: * `user_principal desc` to order by `user_principal` in descending order. * `license_assignment_state` to order by `license_assignment_state` in ascending order. * `last_login_date desc` to order by `last_login_date` in descending order. * `update_time desc` to order by `update_time` in descending order. * `last_login_date desc, user_principal` to order by `last_login_date` in descending order and then by `user_principal` in ascending order.", +"location": "query", +"type": "string" +}, +"pageSize": { +"description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 10. The maximum value is 50; values above 50 will be coerced to 50. If this field is negative, an INVALID_ARGUMENT error is returned.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. A page token, received from a previous `ListUserLicenses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLicenses` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The parent UserStore resource name, format: `projects/{project}/locations/{location}/userStores/{user_store_id}`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/userStores/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/userLicenses", +"response": { +"$ref": "GoogleCloudDiscoveryengineV1ListUserLicensesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/discoveryengine.readwrite" +] +} +} +} +} +} +} +}, +"operations": { +"methods": { +"cancel": { +"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", +"flatPath": "v1/projects/{projectsId}/operations/{operationsId}:cancel", +"httpMethod": "POST", +"id": "discoveryengine.projects.operations.cancel", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "The name of the operation resource to be cancelled.", +"location": "path", +"pattern": "^projects/[^/]+/operations/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}:cancel", +"request": { +"$ref": "GoogleLongrunningCancelOperationRequest" +}, +"response": { +"$ref": "GoogleProtobufEmpty" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/discoveryengine.readwrite" +] +}, +"get": { +"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", +"flatPath": "v1/projects/{projectsId}/operations/{operationsId}", +"httpMethod": "GET", +"id": "discoveryengine.projects.operations.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "The name of the operation resource.", +"location": "path", +"pattern": "^projects/[^/]+/operations/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "GoogleLongrunningOperation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/discoveryengine.readwrite" +] +}, +"list": { +"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", +"flatPath": "v1/projects/{projectsId}/operations", +"httpMethod": "GET", +"id": "discoveryengine.projects.operations.list", +"parameterOrder": [ +"name" +], +"parameters": { +"filter": { +"description": "The standard list filter.", +"location": "query", +"type": "string" +}, +"name": { +"description": "The name of the operation's parent resource.", +"location": "path", +"pattern": "^projects/[^/]+$", +"required": true, +"type": "string" +}, +"pageSize": { +"description": "The standard list page size.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "The standard list page token.", +"location": "query", +"type": "string" +}, +"returnPartialSuccess": { +"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", +"location": "query", +"type": "boolean" +} +}, +"path": "v1/{+name}/operations", +"response": { +"$ref": "GoogleLongrunningListOperationsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/discoveryengine.readwrite" +] +} +} +} +} +} +}, +"revision": "20260215", +"rootUrl": "https://discoveryengine.googleapis.com/", +"schemas": { +"A2aV1APIKeySecurityScheme": { +"id": "A2aV1APIKeySecurityScheme", +"properties": { +"description": { +"description": "Description of this security scheme.", +"type": "string" +}, +"location": { +"description": "Location of the API key, valid values are \"query\", \"header\", or \"cookie\"", +"type": "string" +}, +"name": { +"description": "Name of the header, query or cookie parameter to be used.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1AgentCapabilities": { +"description": "Defines the A2A feature set supported by the agent", +"id": "A2aV1AgentCapabilities", +"properties": { +"extensions": { +"description": "Extensions supported by this agent.", +"items": { +"$ref": "A2aV1AgentExtension" +}, +"type": "array" +}, +"pushNotifications": { +"description": "If the agent can send push notifications to the clients webhook", +"type": "boolean" +}, +"streaming": { +"description": "If the agent will support streaming responses", +"type": "boolean" +} +}, +"type": "object" +}, +"A2aV1AgentCard": { +"description": "AgentCard conveys key information: - Overall details (version, name, description, uses) - Skills; a set of actions/solutions the agent can perform - Default modalities/content types supported by the agent. - Authentication requirements Next ID: 19", +"id": "A2aV1AgentCard", +"properties": { +"additionalInterfaces": { +"description": "Announcement of additional supported transports. Client can use any of the supported transports.", +"items": { +"$ref": "A2aV1AgentInterface" +}, +"type": "array" +}, +"capabilities": { +"$ref": "A2aV1AgentCapabilities", +"description": "A2A Capability set supported by the agent." +}, +"defaultInputModes": { +"description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED The set of interaction modes that the agent supports across all skills. This can be overridden per skill. Defined as mime types.", +"items": { +"type": "string" +}, +"type": "array" +}, +"defaultOutputModes": { +"description": "The mime types supported as outputs from this agent.", +"items": { +"type": "string" +}, +"type": "array" +}, +"description": { +"description": "A description of the agent's domain of action/solution space. Example: \"Agent that helps users with recipes and cooking.\"", +"type": "string" +}, +"documentationUrl": { +"description": "A url to provide additional documentation about the agent.", +"type": "string" +}, +"iconUrl": { +"description": "An optional URL to an icon for the agent.", +"type": "string" +}, +"name": { +"description": "A human readable name for the agent. Example: \"Recipe Agent\"", +"type": "string" +}, +"preferredTransport": { +"description": "The transport of the preferred endpoint. If empty, defaults to JSONRPC.", +"type": "string" +}, +"protocolVersion": { +"description": "The version of the A2A protocol this agent supports.", +"type": "string" +}, +"provider": { +"$ref": "A2aV1AgentProvider", +"description": "The service provider of the agent." +}, +"security": { +"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security requirements for contacting the agent. This list can be seen as an OR of ANDs. Each object in the list describes one possible set of security requirements that must be present on a request. This allows specifying, for example, \"callers must either use OAuth OR an API Key AND mTLS.\" Example: security { schemes { key: \"oauth\" value { list: [\"read\"] } } } security { schemes { key: \"api-key\" } schemes { key: \"mtls\" } }", +"items": { +"$ref": "A2aV1Security" +}, +"type": "array" +}, +"securitySchemes": { +"additionalProperties": { +"$ref": "A2aV1SecurityScheme" +}, +"description": "The security scheme details used for authenticating with this agent.", +"type": "object" +}, +"signatures": { +"description": "JSON Web Signatures computed for this AgentCard.", +"items": { +"$ref": "A2aV1AgentCardSignature" +}, +"type": "array" +}, +"skills": { +"description": "Skills represent a unit of ability an agent can perform. This may somewhat abstract but represents a more focused set of actions that the agent is highly likely to succeed at.", +"items": { +"$ref": "A2aV1AgentSkill" +}, +"type": "array" +}, +"supportsAuthenticatedExtendedCard": { +"description": "Whether the agent supports providing an extended agent card when the user is authenticated, i.e. is the card from .well-known different than the card from GetAgentCard.", +"type": "boolean" +}, +"url": { +"description": "A URL to the address the agent is hosted at. This represents the preferred endpoint as declared by the agent.", +"type": "string" +}, +"version": { +"description": "The version of the agent. Example: \"1.0.0\"", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1AgentCardSignature": { +"description": "AgentCardSignature represents a JWS signature of an AgentCard. This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).", +"id": "A2aV1AgentCardSignature", +"properties": { +"header": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "The unprotected JWS header values.", +"type": "object" +}, +"protected": { +"description": "Required. The protected JWS header for the signature. This is always a base64url-encoded JSON object. Required.", +"type": "string" +}, +"signature": { +"description": "Required. The computed signature, base64url-encoded. Required.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1AgentExtension": { +"description": "A declaration of an extension supported by an Agent.", +"id": "A2aV1AgentExtension", +"properties": { +"description": { +"description": "A description of how this agent uses this extension. Example: \"Google OAuth 2.0 authentication\"", +"type": "string" +}, +"params": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Optional configuration for the extension.", +"type": "object" +}, +"required": { +"description": "Whether the client must follow specific requirements of the extension. Example: false", +"type": "boolean" +}, +"uri": { +"description": "The URI of the extension. Example: \"https://developers.google.com/identity/protocols/oauth2\"", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1AgentInterface": { +"description": "Defines additional transport information for the agent.", +"id": "A2aV1AgentInterface", +"properties": { +"tenant": { +"description": "Tenant to be set in the request when calling the agent. Experimental, might still change for 1.0 release.", +"type": "string" +}, +"transport": { +"description": "The transport supported this url. This is an open form string, to be easily extended for many transport protocols. The core ones officially supported are JSONRPC, GRPC and HTTP+JSON.", +"type": "string" +}, +"url": { +"description": "The url this interface is found at.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1AgentProvider": { +"description": "Represents information about the service provider of an agent.", +"id": "A2aV1AgentProvider", +"properties": { +"organization": { +"description": "The providers organization name Example: \"Google\"", +"type": "string" +}, +"url": { +"description": "The providers reference url Example: \"https://ai.google.dev\"", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1AgentSkill": { +"description": "AgentSkill represents a unit of action/solution that the agent can perform. One can think of this as a type of highly reliable solution that an agent can be tasked to provide. Agents have the autonomy to choose how and when to use specific skills, but clients should have confidence that if the skill is defined that unit of action can be reliably performed.", +"id": "A2aV1AgentSkill", +"properties": { +"description": { +"description": "A human (or llm) readable description of the skill details and behaviors.", +"type": "string" +}, +"examples": { +"description": "A set of example queries that this skill is designed to address. These examples should help the caller to understand how to craft requests to the agent to achieve specific goals. Example: [\"I need a recipe for bread\"]", +"items": { +"type": "string" +}, +"type": "array" +}, +"id": { +"description": "Unique identifier of the skill within this agent.", +"type": "string" +}, +"inputModes": { +"description": "Possible input modalities supported.", +"items": { +"type": "string" +}, +"type": "array" +}, +"name": { +"description": "A human readable name for the skill.", +"type": "string" +}, +"outputModes": { +"description": "Possible output modalities produced", +"items": { +"type": "string" +}, +"type": "array" +}, +"security": { +"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security schemes necessary for the agent to leverage this skill. As in the overall AgentCard.security, this list represents a logical OR of security requirement objects. Each object is a set of security schemes that must be used together (a logical AND). protolint:enable REPEATED_FIELD_NAMES_PLURALIZED", +"items": { +"$ref": "A2aV1Security" +}, +"type": "array" +}, +"tags": { +"description": "A set of tags for the skill to enhance categorization/utilization. Example: [\"cooking\", \"customer support\", \"billing\"]", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"A2aV1Artifact": { +"description": "Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.", +"id": "A2aV1Artifact", +"properties": { +"artifactId": { +"description": "Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.", +"type": "string" +}, +"description": { +"description": "A human readable description of the artifact, optional.", +"type": "string" +}, +"extensions": { +"description": "The URIs of extensions that are present or contributed to this Artifact.", +"items": { +"type": "string" +}, +"type": "array" +}, +"metadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Optional metadata included with the artifact.", +"type": "object" +}, +"name": { +"description": "A human readable name for the artifact.", +"type": "string" +}, +"parts": { +"description": "The content of the artifact.", +"items": { +"$ref": "A2aV1Part" +}, +"type": "array" +} +}, +"type": "object" +}, +"A2aV1AuthenticationInfo": { +"description": "Defines authentication details, used for push notifications.", +"id": "A2aV1AuthenticationInfo", +"properties": { +"credentials": { +"description": "Optional credentials", +"type": "string" +}, +"schemes": { +"description": "Supported authentication schemes - e.g. Basic, Bearer, etc", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"A2aV1AuthorizationCodeOAuthFlow": { +"id": "A2aV1AuthorizationCodeOAuthFlow", +"properties": { +"authorizationUrl": { +"description": "The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS", +"type": "string" +}, +"refreshUrl": { +"description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", +"type": "string" +}, +"scopes": { +"additionalProperties": { +"type": "string" +}, +"description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", +"type": "object" +}, +"tokenUrl": { +"description": "The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1CancelTaskRequest": { +"id": "A2aV1CancelTaskRequest", +"properties": {}, +"type": "object" +}, +"A2aV1ClientCredentialsOAuthFlow": { +"id": "A2aV1ClientCredentialsOAuthFlow", +"properties": { +"refreshUrl": { +"description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", +"type": "string" +}, +"scopes": { +"additionalProperties": { +"type": "string" +}, +"description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", +"type": "object" +}, +"tokenUrl": { +"description": "The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1DataPart": { +"description": "DataPart represents a structured blob. This is most commonly a JSON payload.", +"id": "A2aV1DataPart", +"properties": { +"data": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"type": "object" +} +}, +"type": "object" +}, +"A2aV1FilePart": { +"description": "FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.", +"id": "A2aV1FilePart", +"properties": { +"fileWithBytes": { +"format": "byte", +"type": "string" +}, +"fileWithUri": { +"type": "string" +}, +"mimeType": { +"type": "string" +}, +"name": { +"type": "string" +} +}, +"type": "object" +}, +"A2aV1HTTPAuthSecurityScheme": { +"id": "A2aV1HTTPAuthSecurityScheme", +"properties": { +"bearerFormat": { +"description": "A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.", +"type": "string" +}, +"description": { +"description": "Description of this security scheme.", +"type": "string" +}, +"scheme": { +"description": "The name of the HTTP Authentication scheme to be used in the Authorization header as defined in RFC7235. The values used SHOULD be registered in the IANA Authentication Scheme registry. The value is case-insensitive, as defined in RFC7235.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1ImplicitOAuthFlow": { +"id": "A2aV1ImplicitOAuthFlow", +"properties": { +"authorizationUrl": { +"description": "The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS", +"type": "string" +}, +"refreshUrl": { +"description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", +"type": "string" +}, +"scopes": { +"additionalProperties": { +"type": "string" +}, +"description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", +"type": "object" +} +}, +"type": "object" +}, +"A2aV1ListTaskPushNotificationConfigResponse": { +"id": "A2aV1ListTaskPushNotificationConfigResponse", +"properties": { +"configs": { +"description": "The list of push notification configurations.", +"items": { +"$ref": "A2aV1TaskPushNotificationConfig" +}, +"type": "array" +}, +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1Message": { +"description": "Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.", +"id": "A2aV1Message", +"properties": { +"content": { +"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.", +"items": { +"$ref": "A2aV1Part" +}, +"type": "array" +}, +"contextId": { +"description": "The context id of the message. This is optional and if set, the message will be associated with the given context.", +"type": "string" +}, +"extensions": { +"description": "The URIs of extensions that are present or contributed to this Message.", +"items": { +"type": "string" +}, +"type": "array" +}, +"messageId": { +"description": "The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.", +"type": "string" +}, +"metadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.", +"type": "object" +}, +"role": { +"description": "A role for the message.", +"enum": [ +"ROLE_UNSPECIFIED", +"ROLE_USER", +"ROLE_AGENT" +], +"enumDescriptions": [ +"", +"USER role refers to communication from the client to the server.", +"AGENT role refers to communication from the server to the client." +], +"type": "string" +}, +"taskId": { +"description": "The task id of the message. This is optional and if set, the message will be associated with the given task.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1MutualTlsSecurityScheme": { +"id": "A2aV1MutualTlsSecurityScheme", +"properties": { +"description": { +"description": "Description of this security scheme.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1OAuth2SecurityScheme": { +"id": "A2aV1OAuth2SecurityScheme", +"properties": { +"description": { +"description": "Description of this security scheme.", +"type": "string" +}, +"flows": { +"$ref": "A2aV1OAuthFlows", +"description": "An object containing configuration information for the flow types supported" +}, +"oauth2MetadataUrl": { +"description": "URL to the oauth2 authorization server metadata [RFC8414](https://datatracker.ietf.org/doc/html/rfc8414). TLS is required.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1OAuthFlows": { +"id": "A2aV1OAuthFlows", +"properties": { +"authorizationCode": { +"$ref": "A2aV1AuthorizationCodeOAuthFlow" +}, +"clientCredentials": { +"$ref": "A2aV1ClientCredentialsOAuthFlow" +}, +"implicit": { +"$ref": "A2aV1ImplicitOAuthFlow" +}, +"password": { +"$ref": "A2aV1PasswordOAuthFlow" +} +}, +"type": "object" +}, +"A2aV1OpenIdConnectSecurityScheme": { +"id": "A2aV1OpenIdConnectSecurityScheme", +"properties": { +"description": { +"description": "Description of this security scheme.", +"type": "string" +}, +"openIdConnectUrl": { +"description": "Well-known URL to discover the [[OpenID-Connect-Discovery]] provider metadata.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1Part": { +"description": "Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).", +"id": "A2aV1Part", +"properties": { +"data": { +"$ref": "A2aV1DataPart" +}, +"file": { +"$ref": "A2aV1FilePart" +}, +"metadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Optional metadata associated with this part.", +"type": "object" +}, +"text": { +"type": "string" +} +}, +"type": "object" +}, +"A2aV1PasswordOAuthFlow": { +"id": "A2aV1PasswordOAuthFlow", +"properties": { +"refreshUrl": { +"description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", +"type": "string" +}, +"scopes": { +"additionalProperties": { +"type": "string" +}, +"description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", +"type": "object" +}, +"tokenUrl": { +"description": "The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1PushNotificationConfig": { +"description": "Configuration for setting up push notifications for task updates.", +"id": "A2aV1PushNotificationConfig", +"properties": { +"authentication": { +"$ref": "A2aV1AuthenticationInfo", +"description": "Information about the authentication to sent with the notification" +}, +"id": { +"description": "A unique identifier (e.g. UUID) for this push notification.", +"type": "string" +}, +"token": { +"description": "Token unique for this task/session", +"type": "string" +}, +"url": { +"description": "Url to send the notification too", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1Security": { +"id": "A2aV1Security", +"properties": { +"schemes": { +"additionalProperties": { +"$ref": "A2aV1StringList" +}, +"type": "object" +} +}, +"type": "object" +}, +"A2aV1SecurityScheme": { +"id": "A2aV1SecurityScheme", +"properties": { +"apiKeySecurityScheme": { +"$ref": "A2aV1APIKeySecurityScheme" +}, +"httpAuthSecurityScheme": { +"$ref": "A2aV1HTTPAuthSecurityScheme" +}, +"mtlsSecurityScheme": { +"$ref": "A2aV1MutualTlsSecurityScheme" +}, +"oauth2SecurityScheme": { +"$ref": "A2aV1OAuth2SecurityScheme" +}, +"openIdConnectSecurityScheme": { +"$ref": "A2aV1OpenIdConnectSecurityScheme" +} +}, +"type": "object" +}, +"A2aV1SendMessageConfiguration": { +"description": "Configuration of a send message request.", +"id": "A2aV1SendMessageConfiguration", +"properties": { +"acceptedOutputModes": { +"description": "The output modes that the agent is expected to respond with.", +"items": { +"type": "string" +}, +"type": "array" +}, +"blocking": { +"description": "If true, the message will be blocking until the task is completed. If false, the message will be non-blocking and the task will be returned immediately. It is the caller's responsibility to check for any task updates.", +"type": "boolean" +}, +"historyLength": { +"description": "The maximum number of messages to include in the history. if 0, the history will be unlimited.", +"format": "int32", +"type": "integer" +}, +"pushNotification": { +"$ref": "A2aV1PushNotificationConfig", +"description": "A configuration of a webhook that can be used to receive updates" +} +}, +"type": "object" +}, +"A2aV1SendMessageRequest": { +"description": "/////////// Request Messages ///////////", +"id": "A2aV1SendMessageRequest", +"properties": { +"configuration": { +"$ref": "A2aV1SendMessageConfiguration", +"description": "Configuration for the send request." +}, +"message": { +"$ref": "A2aV1Message", +"description": "Required. The message to send to the agent." +}, +"metadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Optional metadata for the request.", +"type": "object" +} +}, +"type": "object" +}, +"A2aV1SendMessageResponse": { +"description": "////// Response Messages ///////////", +"id": "A2aV1SendMessageResponse", +"properties": { +"message": { +"$ref": "A2aV1Message" +}, +"task": { +"$ref": "A2aV1Task" } }, -"path": "v1/{+name}", -"request": { -"$ref": "GoogleCloudDiscoveryengineV1UserStore" +"type": "object" }, -"response": { -"$ref": "GoogleCloudDiscoveryengineV1UserStore" +"A2aV1StreamResponse": { +"description": "The stream response for a message. The stream should be one of the following sequences: If the response is a message, the stream should contain one, and only one, message and then close If the response is a task lifecycle, the first response should be a Task object followed by zero or more TaskStatusUpdateEvents and TaskArtifactUpdateEvents. The stream should complete when the Task if in an interrupted or terminal state. A stream that ends before these conditions are met are", +"id": "A2aV1StreamResponse", +"properties": { +"artifactUpdate": { +"$ref": "A2aV1TaskArtifactUpdateEvent" }, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/discoveryengine.readwrite" -] +"message": { +"$ref": "A2aV1Message" +}, +"statusUpdate": { +"$ref": "A2aV1TaskStatusUpdateEvent" +}, +"task": { +"$ref": "A2aV1Task" } }, -"resources": { -"licenseConfigsUsageStats": { -"methods": { +"type": "object" +}, +"A2aV1StringList": { +"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED", +"id": "A2aV1StringList", +"properties": { "list": { -"description": "Lists all the LicenseConfigUsageStatss associated with the project.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/userStores/{userStoresId}/licenseConfigsUsageStats", -"httpMethod": "GET", -"id": "discoveryengine.projects.locations.userStores.licenseConfigsUsageStats.list", -"parameterOrder": [ -"parent" -], -"parameters": { -"parent": { -"description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/userStores/{user_store_id}`.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/userStores/[^/]+$", -"required": true, +"items": { "type": "string" +}, +"type": "array" } }, -"path": "v1/{+parent}/licenseConfigsUsageStats", -"response": { -"$ref": "GoogleCloudDiscoveryengineV1ListLicenseConfigsUsageStatsResponse" +"type": "object" }, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/discoveryengine.readwrite" -] -} -} +"A2aV1Task": { +"description": "Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.", +"id": "A2aV1Task", +"properties": { +"artifacts": { +"description": "A set of output artifacts for a Task.", +"items": { +"$ref": "A2aV1Artifact" }, -"userLicenses": { -"methods": { -"list": { -"description": "Lists the User Licenses.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/userStores/{userStoresId}/userLicenses", -"httpMethod": "GET", -"id": "discoveryengine.projects.locations.userStores.userLicenses.list", -"parameterOrder": [ -"parent" -], -"parameters": { -"orderBy": { -"description": "Optional. The order in which the UserLicenses are listed. The value must be a comma-separated list of fields. Default sorting order is ascending. To specify descending order for a field, append a \" desc\" suffix. Redundant space characters in the syntax are insignificant. Supported fields: * `license_assignment_state` * `user_principal` * `user_profile` * `last_login_date` * `update_time` If not set, the default ordering is by `user_principal`. Examples: * `user_principal desc` to order by `user_principal` in descending order. * `license_assignment_state` to order by `license_assignment_state` in ascending order. * `last_login_date desc` to order by `last_login_date` in descending order. * `update_time desc` to order by `update_time` in descending order. * `last_login_date desc, user_principal` to order by `last_login_date` in descending order and then by `user_principal` in ascending order.", -"location": "query", +"type": "array" +}, +"contextId": { +"description": "Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.", "type": "string" }, -"pageSize": { -"description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 10. The maximum value is 50; values above 50 will be coerced to 50. If this field is negative, an INVALID_ARGUMENT error is returned.", -"format": "int32", -"location": "query", -"type": "integer" +"history": { +"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.", +"items": { +"$ref": "A2aV1Message" }, -"pageToken": { -"description": "Optional. A page token, received from a previous `ListUserLicenses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLicenses` must match the call that provided the page token.", -"location": "query", -"type": "string" +"type": "array" }, -"parent": { -"description": "Required. The parent UserStore resource name, format: `projects/{project}/locations/{location}/userStores/{user_store_id}`.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/userStores/[^/]+$", -"required": true, +"id": { +"description": "Unique identifier (e.g. UUID) for the task, generated by the server for a new task.", "type": "string" -} }, -"path": "v1/{+parent}/userLicenses", -"response": { -"$ref": "GoogleCloudDiscoveryengineV1ListUserLicensesResponse" +"metadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" }, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/discoveryengine.readwrite" -] -} -} -} -} -} +"description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.", +"type": "object" +}, +"status": { +"$ref": "A2aV1TaskStatus", +"description": "The current status of a Task, including state and a message." } }, -"operations": { -"methods": { -"cancel": { -"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", -"flatPath": "v1/projects/{projectsId}/operations/{operationsId}:cancel", -"httpMethod": "POST", -"id": "discoveryengine.projects.operations.cancel", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "The name of the operation resource to be cancelled.", -"location": "path", -"pattern": "^projects/[^/]+/operations/[^/]+$", -"required": true, +"type": "object" +}, +"A2aV1TaskArtifactUpdateEvent": { +"description": "TaskArtifactUpdateEvent represents a task delta where an artifact has been generated.", +"id": "A2aV1TaskArtifactUpdateEvent", +"properties": { +"append": { +"description": "Whether this should be appended to a prior one produced", +"type": "boolean" +}, +"artifact": { +"$ref": "A2aV1Artifact", +"description": "The artifact itself" +}, +"contextId": { +"description": "The id of the context that this task belongs too", "type": "string" -} }, -"path": "v1/{+name}:cancel", -"request": { -"$ref": "GoogleLongrunningCancelOperationRequest" +"lastChunk": { +"description": "Whether this represents the last part of an artifact", +"type": "boolean" }, -"response": { -"$ref": "GoogleProtobufEmpty" +"metadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" }, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/discoveryengine.readwrite" -] +"description": "Optional metadata associated with the artifact update.", +"type": "object" }, -"get": { -"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", -"flatPath": "v1/projects/{projectsId}/operations/{operationsId}", -"httpMethod": "GET", -"id": "discoveryengine.projects.operations.get", -"parameterOrder": [ -"name" -], -"parameters": { +"taskId": { +"description": "The id of the task for this artifact", +"type": "string" +} +}, +"type": "object" +}, +"A2aV1TaskPushNotificationConfig": { +"id": "A2aV1TaskPushNotificationConfig", +"properties": { "name": { -"description": "The name of the operation resource.", -"location": "path", -"pattern": "^projects/[^/]+/operations/[^/]+$", -"required": true, +"description": "The resource name of the config. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}", "type": "string" +}, +"pushNotificationConfig": { +"$ref": "A2aV1PushNotificationConfig", +"description": "The push notification configuration details." } }, -"path": "v1/{+name}", -"response": { -"$ref": "GoogleLongrunningOperation" +"type": "object" }, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/discoveryengine.readwrite" -] +"A2aV1TaskStatus": { +"description": "A container for the status of a task", +"id": "A2aV1TaskStatus", +"properties": { +"message": { +"$ref": "A2aV1Message", +"description": "A message associated with the status." }, -"list": { -"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", -"flatPath": "v1/projects/{projectsId}/operations", -"httpMethod": "GET", -"id": "discoveryengine.projects.operations.list", -"parameterOrder": [ -"name" +"state": { +"description": "The current state of this task", +"enum": [ +"TASK_STATE_UNSPECIFIED", +"TASK_STATE_SUBMITTED", +"TASK_STATE_WORKING", +"TASK_STATE_COMPLETED", +"TASK_STATE_FAILED", +"TASK_STATE_CANCELLED", +"TASK_STATE_INPUT_REQUIRED", +"TASK_STATE_REJECTED", +"TASK_STATE_AUTH_REQUIRED" +], +"enumDescriptions": [ +"", +"Represents the status that acknowledges a task is created", +"Represents the status that a task is actively being processed", +"Represents the status a task is finished. This is a terminal state", +"Represents the status a task is done but failed. This is a terminal state", +"Represents the status a task was cancelled before it finished. This is a terminal state.", +"Represents the status that the task requires information to complete. This is an interrupted state.", +"Represents the status that the agent has decided to not perform the task. This may be done during initial task creation or later once an agent has determined it can't or won't proceed. This is a terminal state.", +"Represents the state that some authentication is needed from the upstream client. Authentication is expected to come out-of-band thus this is not an interrupted or terminal state." ], -"parameters": { -"filter": { -"description": "The standard list filter.", -"location": "query", "type": "string" }, -"name": { -"description": "The name of the operation's parent resource.", -"location": "path", -"pattern": "^projects/[^/]+$", -"required": true, +"timestamp": { +"description": "Timestamp when the status was recorded. Example: \"2023-10-27T10:00:00Z\"", +"format": "google-datetime", "type": "string" +} }, -"pageSize": { -"description": "The standard list page size.", -"format": "int32", -"location": "query", -"type": "integer" +"type": "object" }, -"pageToken": { -"description": "The standard list page token.", -"location": "query", +"A2aV1TaskStatusUpdateEvent": { +"description": "TaskStatusUpdateEvent is a delta even on a task indicating that a task has changed.", +"id": "A2aV1TaskStatusUpdateEvent", +"properties": { +"contextId": { +"description": "The id of the context that the task belongs to", "type": "string" }, -"returnPartialSuccess": { -"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", -"location": "query", +"final": { +"description": "Whether this is the last status update expected for this task.", "type": "boolean" -} }, -"path": "v1/{+name}/operations", -"response": { -"$ref": "GoogleLongrunningListOperationsResponse" +"metadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" }, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/discoveryengine.readwrite" -] -} -} -} -} +"description": "Optional metadata to associate with the task update.", +"type": "object" +}, +"status": { +"$ref": "A2aV1TaskStatus", +"description": "The new status of the task." +}, +"taskId": { +"description": "The id of the task that is changed", +"type": "string" } }, -"revision": "20260209", -"rootUrl": "https://discoveryengine.googleapis.com/", -"schemas": { +"type": "object" +}, "GoogleApiDistribution": { "description": "`Distribution` contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets. The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` fields meaningless.", "id": "GoogleApiDistribution", @@ -13244,7 +14552,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", -"GOOGLE_SITES" +"GOOGLE_SITES", +"REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -13260,7 +14569,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", -"Google Sites connector." +"Google Sites connector.", +"Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -14455,6 +15765,13 @@ ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -15703,13 +17020,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -22541,7 +23860,8 @@ false "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", -"GOOGLE_SITES" +"GOOGLE_SITES", +"REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -22557,7 +23877,8 @@ false "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", -"Google Sites connector." +"Google Sites connector.", +"Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -23660,6 +24981,13 @@ false ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -24956,13 +26284,15 @@ false "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -26162,7 +27492,7 @@ false "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { -"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", +"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, @@ -28832,6 +30162,13 @@ false ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -29795,13 +31132,15 @@ false "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -30432,7 +31771,7 @@ false "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { -"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", +"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json index 0c459ccebda..0cd670e4a91 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json @@ -12250,7 +12250,7 @@ } } }, -"revision": "20260209", +"revision": "20260215", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -13723,7 +13723,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", -"GOOGLE_SITES" +"GOOGLE_SITES", +"REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -13739,7 +13740,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", -"Google Sites connector." +"Google Sites connector.", +"Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -14728,6 +14730,13 @@ ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -15514,13 +15523,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -20020,13 +20031,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -21911,7 +21924,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", -"GOOGLE_SITES" +"GOOGLE_SITES", +"REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -21927,7 +21941,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", -"Google Sites connector." +"Google Sites connector.", +"Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -23294,6 +23309,13 @@ ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -25475,13 +25497,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -28165,7 +28189,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { -"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", +"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, @@ -33339,6 +33363,13 @@ false ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -34302,13 +34333,15 @@ false "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -34939,7 +34972,7 @@ false "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { -"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", +"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json index 7fb9798bd70..cfbd1480fe5 100644 --- a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json +++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json @@ -9167,7 +9167,7 @@ } } }, -"revision": "20260209", +"revision": "20260215", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -10640,7 +10640,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", -"GOOGLE_SITES" +"GOOGLE_SITES", +"REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -10656,7 +10657,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", -"Google Sites connector." +"Google Sites connector.", +"Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -11645,6 +11647,13 @@ ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -12431,13 +12440,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -15873,7 +15884,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", -"GOOGLE_SITES" +"GOOGLE_SITES", +"REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -15889,7 +15901,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", -"Google Sites connector." +"Google Sites connector.", +"Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -16992,6 +17005,13 @@ ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -18288,13 +18308,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -19494,7 +19516,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { -"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", +"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, @@ -25648,6 +25670,13 @@ false ], "type": "string" }, +"connectorTenantInfo": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", +"type": "object" +}, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -27083,13 +27112,15 @@ false "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", -"SUBSCRIPTION_TERM_THREE_YEARS" +"SUBSCRIPTION_TERM_THREE_YEARS", +"SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", -"3 years." +"3 years.", +"Custom term. Must set the end_date." ], "type": "string" }, @@ -28851,7 +28882,7 @@ false "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { -"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", +"description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, From 92c1d6ba3b0d176791fd5d34cc8bdad8c8ff918a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 12/29] feat(firebaseml): update the api #### firebaseml:v2beta The following keys were added: - schemas.GoogleCloudAiplatformV1beta1FunctionResponse.properties.scheduling.type (Total Keys: 1) --- ....projects.locations.publishers.models.html | 12 +++++++++-- .../documents/firebaseml.v2beta.json | 20 +++++++++++++++++-- 2 files changed, 28 insertions(+), 4 deletions(-) diff --git a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html index 04193efa68f..d0e7caee716 100644 --- a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html +++ b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html @@ -157,6 +157,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -352,6 +353,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -678,6 +680,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -883,6 +886,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -1221,6 +1225,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -1248,7 +1253,7 @@

Method Details

"googleMapsWidgetContextToken": "A String", # Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. "groundingChunks": [ # A list of supporting references retrieved from the grounding source. This field is populated when the grounding source is Google Search, Vertex AI Search, or Google Maps. { # A piece of evidence that supports a claim made by the model. This is used to show a citation for a claim made by the model. When grounding is enabled, the model returns a `GroundingChunk` that contains a reference to the source of the information. - "maps": { # A `Maps` chunk is a piece of evidence that comes from Google Maps. It contains information about a place, such as its name, address, and reviews. This is used to provide the user with rich, location-based information. # A grounding chunk from Google Maps. See the `Maps` message for details. + "maps": { # A `Maps` chunk is a piece of evidence that comes from Google Maps, containing information about places or routes. This is used to provide the user with rich, location-based information. # A grounding chunk from Google Maps. See the `Maps` message for details. "placeAnswerSources": { # The sources that were used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as URIs to flag content. # The sources that were used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as URIs to flag content. "reviewSnippets": [ # Snippets of reviews that were used to generate the answer. { # A review snippet that is used to generate the answer. @@ -1481,6 +1486,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -1686,6 +1692,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -2024,6 +2031,7 @@

Method Details

"response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. "a_key": "", # Properties of the object. }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. }, "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. "data": "A String", # Required. The raw bytes of the data. @@ -2051,7 +2059,7 @@

Method Details

"googleMapsWidgetContextToken": "A String", # Optional. Output only. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps. "groundingChunks": [ # A list of supporting references retrieved from the grounding source. This field is populated when the grounding source is Google Search, Vertex AI Search, or Google Maps. { # A piece of evidence that supports a claim made by the model. This is used to show a citation for a claim made by the model. When grounding is enabled, the model returns a `GroundingChunk` that contains a reference to the source of the information. - "maps": { # A `Maps` chunk is a piece of evidence that comes from Google Maps. It contains information about a place, such as its name, address, and reviews. This is used to provide the user with rich, location-based information. # A grounding chunk from Google Maps. See the `Maps` message for details. + "maps": { # A `Maps` chunk is a piece of evidence that comes from Google Maps, containing information about places or routes. This is used to provide the user with rich, location-based information. # A grounding chunk from Google Maps. See the `Maps` message for details. "placeAnswerSources": { # The sources that were used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as URIs to flag content. # The sources that were used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as URIs to flag content. "reviewSnippets": [ # Snippets of reviews that were used to generate the answer. { # A review snippet that is used to generate the answer. diff --git a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json index 5bf2babcec8..dfbe2c59c11 100644 --- a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json +++ b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json @@ -206,7 +206,7 @@ } } }, -"revision": "20260201", +"revision": "20260215", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -978,6 +978,22 @@ }, "description": "Required. The function response in JSON object format. Use \"output\" key to specify function output and \"error\" key to specify error details (if any). If \"output\" and \"error\" keys are not specified, then whole \"response\" is treated as function output.", "type": "object" +}, +"scheduling": { +"description": "Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE.", +"enum": [ +"SCHEDULING_UNSPECIFIED", +"SILENT", +"WHEN_IDLE", +"INTERRUPT" +], +"enumDescriptions": [ +"This value is unused.", +"Only add the result to the conversation context, do not interrupt or trigger generation.", +"Add the result to the conversation context, and prompt to generate output without interrupting ongoing generation.", +"Add the result to the conversation context, interrupt ongoing generation and prompt to generate output." +], +"type": "string" } }, "type": "object" @@ -1554,7 +1570,7 @@ "type": "object" }, "GoogleCloudAiplatformV1beta1GroundingChunkMaps": { -"description": "A `Maps` chunk is a piece of evidence that comes from Google Maps. It contains information about a place, such as its name, address, and reviews. This is used to provide the user with rich, location-based information.", +"description": "A `Maps` chunk is a piece of evidence that comes from Google Maps, containing information about places or routes. This is used to provide the user with rich, location-based information.", "id": "GoogleCloudAiplatformV1beta1GroundingChunkMaps", "properties": { "placeAnswerSources": { From 910f448feb19d27938cfdecb2c5fca55bfb1bbc4 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 13/29] feat(firestore): update the api #### firestore:v1 The following keys were deleted: - schemas.GoogleFirestoreAdminV1LocationMetadata.properties.availableStoragePlacements (Total Keys: 2) --- .../firestore_v1.projects.locations.backups.html | 4 ++-- .../discovery_cache/documents/firestore.v1.json | 14 +++----------- 2 files changed, 5 insertions(+), 13 deletions(-) diff --git a/docs/dyn/firestore_v1.projects.locations.backups.html b/docs/dyn/firestore_v1.projects.locations.backups.html index 227b49a7c00..a762d949a56 100644 --- a/docs/dyn/firestore_v1.projects.locations.backups.html +++ b/docs/dyn/firestore_v1.projects.locations.backups.html @@ -128,7 +128,7 @@

Method Details

"database": "A String", # Output only. Name of the Firestore database that the backup is from. Format is `projects/{project}/databases/{database}`. "databaseUid": "A String", # Output only. The system-generated UUID4 for the Firestore database that the backup is from. "expireTime": "A String", # Output only. The timestamp at which this backup expires. - "name": "A String", # Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`. + "name": "A String", # Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`. The location in the name will be the Standard Managed Multi-Region (SMMR) location (e.g. `us`) if the backup was created with an SMMR location, or the Google Managed Multi-Region (GMMR) location (e.g. `nam5`) if the backup was created with a GMMR location. "snapshotTime": "A String", # Output only. The backup contains an externally consistent copy of the database at this time. "state": "A String", # Output only. The current state of the backup. "stats": { # Backup specific statistics. # Output only. Statistics about the backup. This data only becomes available after the backup is fully materialized to secondary storage. This field will be empty till then. @@ -160,7 +160,7 @@

Method Details

"database": "A String", # Output only. Name of the Firestore database that the backup is from. Format is `projects/{project}/databases/{database}`. "databaseUid": "A String", # Output only. The system-generated UUID4 for the Firestore database that the backup is from. "expireTime": "A String", # Output only. The timestamp at which this backup expires. - "name": "A String", # Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`. + "name": "A String", # Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`. The location in the name will be the Standard Managed Multi-Region (SMMR) location (e.g. `us`) if the backup was created with an SMMR location, or the Google Managed Multi-Region (GMMR) location (e.g. `nam5`) if the backup was created with a GMMR location. "snapshotTime": "A String", # Output only. The backup contains an externally consistent copy of the database at this time. "state": "A String", # Output only. The current state of the backup. "stats": { # Backup specific statistics. # Output only. Statistics about the backup. This data only becomes available after the backup is fully materialized to secondary storage. This field will be empty till then. diff --git a/googleapiclient/discovery_cache/documents/firestore.v1.json b/googleapiclient/discovery_cache/documents/firestore.v1.json index 60b369e6df6..ad1c6c805e4 100644 --- a/googleapiclient/discovery_cache/documents/firestore.v1.json +++ b/googleapiclient/discovery_cache/documents/firestore.v1.json @@ -2445,7 +2445,7 @@ } } }, -"revision": "20260130", +"revision": "20260212", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -3285,7 +3285,7 @@ "type": "string" }, "name": { -"description": "Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`.", +"description": "Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`. The location in the name will be the Standard Managed Multi-Region (SMMR) location (e.g. `us`) if the backup was created with an SMMR location, or the Google Managed Multi-Region (GMMR) location (e.g. `nam5`) if the backup was created with a GMMR location.", "readOnly": true, "type": "string" }, @@ -4475,15 +4475,7 @@ "GoogleFirestoreAdminV1LocationMetadata": { "description": "The metadata message for google.cloud.location.Location.metadata.", "id": "GoogleFirestoreAdminV1LocationMetadata", -"properties": { -"availableStoragePlacements": { -"description": "The storage placements available in the location. When the location represents a Standard Managed Multi-Region (SMMR) like \"us\", this field lists the available Google-Managed Multi-Regions (GMMRs) within it, such as \"nam5\" or \"eur3\".", -"items": { -"type": "string" -}, -"type": "array" -} -}, +"properties": {}, "type": "object" }, "GoogleFirestoreAdminV1PitrSnapshot": { From 567dab56d274b6bd584fd4d9821d77b596220977 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 14/29] feat(gkebackup): update the api #### gkebackup:v1 The following keys were added: - schemas.Backup.properties.namespaceCount (Total Keys: 3) - schemas.BackupPlan.properties.protectedNamespaceCount (Total Keys: 3) --- ..._v1.projects.locations.backupPlans.backups.html | 4 ++++ ...kebackup_v1.projects.locations.backupPlans.html | 4 ++++ .../discovery_cache/documents/gkebackup.v1.json | 14 +++++++++++++- 3 files changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html index 5cd56b91c4a..b452740c27a 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html +++ b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.html @@ -155,6 +155,7 @@

Method Details

}, "manual": True or False, # Output only. This flag indicates whether this Backup resource was created manually by a user or via a schedule in the BackupPlan. A value of True means that the Backup was created manually. "name": "A String", # Output only. Identifier. The fully qualified name of the Backup. `projects/*/locations/*/backupPlans/*/backups/*` + "namespaceCount": 42, # Output only. The total number of user managed namespaces contained in the Backup. "permissiveMode": True or False, # Output only. If false, Backup will fail when Backup for GKE detects Kubernetes configuration that is non-standard or requires additional setup to restore. Inherited from the parent BackupPlan's permissive_mode value. "podCount": 42, # Output only. The total number of Kubernetes Pods contained in the Backup. "resourceCount": 42, # Output only. The total number of Kubernetes resources included in the Backup. @@ -304,6 +305,7 @@

Method Details

}, "manual": True or False, # Output only. This flag indicates whether this Backup resource was created manually by a user or via a schedule in the BackupPlan. A value of True means that the Backup was created manually. "name": "A String", # Output only. Identifier. The fully qualified name of the Backup. `projects/*/locations/*/backupPlans/*/backups/*` + "namespaceCount": 42, # Output only. The total number of user managed namespaces contained in the Backup. "permissiveMode": True or False, # Output only. If false, Backup will fail when Backup for GKE detects Kubernetes configuration that is non-standard or requires additional setup to restore. Inherited from the parent BackupPlan's permissive_mode value. "podCount": 42, # Output only. The total number of Kubernetes Pods contained in the Backup. "resourceCount": 42, # Output only. The total number of Kubernetes resources included in the Backup. @@ -461,6 +463,7 @@

Method Details

}, "manual": True or False, # Output only. This flag indicates whether this Backup resource was created manually by a user or via a schedule in the BackupPlan. A value of True means that the Backup was created manually. "name": "A String", # Output only. Identifier. The fully qualified name of the Backup. `projects/*/locations/*/backupPlans/*/backups/*` + "namespaceCount": 42, # Output only. The total number of user managed namespaces contained in the Backup. "permissiveMode": True or False, # Output only. If false, Backup will fail when Backup for GKE detects Kubernetes configuration that is non-standard or requires additional setup to restore. Inherited from the parent BackupPlan's permissive_mode value. "podCount": 42, # Output only. The total number of Kubernetes Pods contained in the Backup. "resourceCount": 42, # Output only. The total number of Kubernetes resources included in the Backup. @@ -559,6 +562,7 @@

Method Details

}, "manual": True or False, # Output only. This flag indicates whether this Backup resource was created manually by a user or via a schedule in the BackupPlan. A value of True means that the Backup was created manually. "name": "A String", # Output only. Identifier. The fully qualified name of the Backup. `projects/*/locations/*/backupPlans/*/backups/*` + "namespaceCount": 42, # Output only. The total number of user managed namespaces contained in the Backup. "permissiveMode": True or False, # Output only. If false, Backup will fail when Backup for GKE detects Kubernetes configuration that is non-standard or requires additional setup to restore. Inherited from the parent BackupPlan's permissive_mode value. "podCount": 42, # Output only. The total number of Kubernetes Pods contained in the Backup. "resourceCount": 42, # Output only. The total number of Kubernetes resources included in the Backup. diff --git a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html index df522c6e52b..d6402e7e50d 100644 --- a/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html +++ b/docs/dyn/gkebackup_v1.projects.locations.backupPlans.html @@ -202,6 +202,7 @@

Method Details

}, "lastSuccessfulBackupTime": "A String", # Output only. Completion time of the last successful Backup. This is sourced from a successful Backup's complete_time field. This field is added to maintain consistency with BackupPlanBinding to display last successful backup time. "name": "A String", # Output only. Identifier. The full name of the BackupPlan resource. Format: `projects/*/locations/*/backupPlans/*` + "protectedNamespaceCount": 42, # Output only. The number of user managed namespaces backed up in the last successful Backup created via this BackupPlan. "protectedPodCount": 42, # Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan. "retentionPolicy": { # RetentionPolicy defines a Backup retention policy for a BackupPlan. # Optional. RetentionPolicy governs lifecycle of Backups created under this plan. "backupDeleteLockDays": 42, # Optional. Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90 (inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup's (create_time + backup_delete_lock_days). Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking) @@ -368,6 +369,7 @@

Method Details

}, "lastSuccessfulBackupTime": "A String", # Output only. Completion time of the last successful Backup. This is sourced from a successful Backup's complete_time field. This field is added to maintain consistency with BackupPlanBinding to display last successful backup time. "name": "A String", # Output only. Identifier. The full name of the BackupPlan resource. Format: `projects/*/locations/*/backupPlans/*` + "protectedNamespaceCount": 42, # Output only. The number of user managed namespaces backed up in the last successful Backup created via this BackupPlan. "protectedPodCount": 42, # Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan. "retentionPolicy": { # RetentionPolicy defines a Backup retention policy for a BackupPlan. # Optional. RetentionPolicy governs lifecycle of Backups created under this plan. "backupDeleteLockDays": 42, # Optional. Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90 (inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup's (create_time + backup_delete_lock_days). Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking) @@ -546,6 +548,7 @@

Method Details

}, "lastSuccessfulBackupTime": "A String", # Output only. Completion time of the last successful Backup. This is sourced from a successful Backup's complete_time field. This field is added to maintain consistency with BackupPlanBinding to display last successful backup time. "name": "A String", # Output only. Identifier. The full name of the BackupPlan resource. Format: `projects/*/locations/*/backupPlans/*` + "protectedNamespaceCount": 42, # Output only. The number of user managed namespaces backed up in the last successful Backup created via this BackupPlan. "protectedPodCount": 42, # Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan. "retentionPolicy": { # RetentionPolicy defines a Backup retention policy for a BackupPlan. # Optional. RetentionPolicy governs lifecycle of Backups created under this plan. "backupDeleteLockDays": 42, # Optional. Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90 (inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup's (create_time + backup_delete_lock_days). Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking) @@ -662,6 +665,7 @@

Method Details

}, "lastSuccessfulBackupTime": "A String", # Output only. Completion time of the last successful Backup. This is sourced from a successful Backup's complete_time field. This field is added to maintain consistency with BackupPlanBinding to display last successful backup time. "name": "A String", # Output only. Identifier. The full name of the BackupPlan resource. Format: `projects/*/locations/*/backupPlans/*` + "protectedNamespaceCount": 42, # Output only. The number of user managed namespaces backed up in the last successful Backup created via this BackupPlan. "protectedPodCount": 42, # Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan. "retentionPolicy": { # RetentionPolicy defines a Backup retention policy for a BackupPlan. # Optional. RetentionPolicy governs lifecycle of Backups created under this plan. "backupDeleteLockDays": 42, # Optional. Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90 (inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup's (create_time + backup_delete_lock_days). Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking) diff --git a/googleapiclient/discovery_cache/documents/gkebackup.v1.json b/googleapiclient/discovery_cache/documents/gkebackup.v1.json index 34c0649b7b5..6e1495392a0 100644 --- a/googleapiclient/discovery_cache/documents/gkebackup.v1.json +++ b/googleapiclient/discovery_cache/documents/gkebackup.v1.json @@ -2338,7 +2338,7 @@ } } }, -"revision": "20260202", +"revision": "20260213", "rootUrl": "https://gkebackup.googleapis.com/", "schemas": { "AuditConfig": { @@ -2660,6 +2660,12 @@ "readOnly": true, "type": "string" }, +"namespaceCount": { +"description": "Output only. The total number of user managed namespaces contained in the Backup.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, "permissiveMode": { "description": "Output only. If false, Backup will fail when Backup for GKE detects Kubernetes configuration that is non-standard or requires additional setup to restore. Inherited from the parent BackupPlan's permissive_mode value.", "readOnly": true, @@ -2957,6 +2963,12 @@ "readOnly": true, "type": "string" }, +"protectedNamespaceCount": { +"description": "Output only. The number of user managed namespaces backed up in the last successful Backup created via this BackupPlan.", +"format": "int32", +"readOnly": true, +"type": "integer" +}, "protectedPodCount": { "description": "Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.", "format": "int32", From 3bfb8c62fc5011da79e2cbb042551f0a025930ef Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 15/29] feat(gkehub): update the api #### gkehub:v1 The following keys were added: - schemas.CompliancePostureConfig.deprecated (Total Keys: 1) - schemas.DefaultClusterConfig.properties.compliancePostureConfig.deprecated (Total Keys: 1) #### gkehub:v1alpha The following keys were deleted: - schemas.ExcludedCluster (Total Keys: 6) - schemas.FeatureUpdate (Total Keys: 4) - schemas.Rollout.properties.excludedClusters (Total Keys: 3) - schemas.Rollout.properties.feature.$ref (Total Keys: 1) - schemas.Rollout.properties.schedule (Total Keys: 2) - schemas.Schedule (Total Keys: 5) - schemas.WaveSchedule (Total Keys: 8) The following keys were added: - schemas.ClusterUpgradeFleetSpec.properties.upgradeEngine (Total Keys: 2) - schemas.CompliancePostureConfig.deprecated (Total Keys: 1) - schemas.DefaultClusterConfig.properties.compliancePostureConfig.deprecated (Total Keys: 1) - schemas.RolloutSequence.properties.state (Total Keys: 2) - schemas.RolloutSequenceState (Total Keys: 7) #### gkehub:v1beta The following keys were deleted: - schemas.ExcludedCluster (Total Keys: 6) - schemas.FeatureUpdate (Total Keys: 4) - schemas.Rollout.properties.excludedClusters (Total Keys: 3) - schemas.Rollout.properties.feature.$ref (Total Keys: 1) - schemas.Rollout.properties.schedule (Total Keys: 2) - schemas.Schedule (Total Keys: 5) - schemas.WaveSchedule (Total Keys: 8) The following keys were added: - schemas.CompliancePostureConfig.deprecated (Total Keys: 1) - schemas.DefaultClusterConfig.properties.compliancePostureConfig.deprecated (Total Keys: 1) - schemas.RolloutSequence.properties.state (Total Keys: 2) - schemas.RolloutSequenceState (Total Keys: 7) --- ...hub_v1.organizations.locations.fleets.html | 4 +- .../gkehub_v1.projects.locations.fleets.html | 16 +- ...1alpha.organizations.locations.fleets.html | 4 +- ...b_v1alpha.projects.locations.features.html | 4 + ...hub_v1alpha.projects.locations.fleets.html | 16 +- ...a.projects.locations.rolloutSequences.html | 24 ++ ...b_v1alpha.projects.locations.rollouts.html | 58 ----- ...v1beta.organizations.locations.fleets.html | 4 +- ...ehub_v1beta.projects.locations.fleets.html | 16 +- ...a.projects.locations.rolloutSequences.html | 24 ++ ...ub_v1beta.projects.locations.rollouts.html | 58 ----- .../discovery_cache/documents/gkehub.v1.json | 26 ++- .../documents/gkehub.v1alpha.json | 207 ++++++++---------- .../documents/gkehub.v1beta.json | 192 +++++++--------- 14 files changed, 271 insertions(+), 382 deletions(-) diff --git a/docs/dyn/gkehub_v1.organizations.locations.fleets.html b/docs/dyn/gkehub_v1.organizations.locations.fleets.html index bcce89148d8..96752cf0e0c 100644 --- a/docs/dyn/gkehub_v1.organizations.locations.fleets.html +++ b/docs/dyn/gkehub_v1.organizations.locations.fleets.html @@ -118,7 +118,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -126,7 +126,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, diff --git a/docs/dyn/gkehub_v1.projects.locations.fleets.html b/docs/dyn/gkehub_v1.projects.locations.fleets.html index f307cc13a10..7a97a6a6358 100644 --- a/docs/dyn/gkehub_v1.projects.locations.fleets.html +++ b/docs/dyn/gkehub_v1.projects.locations.fleets.html @@ -121,7 +121,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -129,7 +129,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -236,7 +236,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -244,7 +244,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -292,7 +292,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -300,7 +300,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -356,7 +356,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -364,7 +364,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, diff --git a/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html b/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html index ba6f7f337c4..0b1fc484962 100644 --- a/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html +++ b/docs/dyn/gkehub_v1alpha.organizations.locations.fleets.html @@ -118,7 +118,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -126,7 +126,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.features.html b/docs/dyn/gkehub_v1alpha.projects.locations.features.html index d2cedbf6b3c..9bf747f57c7 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.features.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.features.html @@ -1054,6 +1054,7 @@

Method Details

"postConditions": { # Post conditional checks after an upgrade has been applied on all eligible clusters. # Required. Post conditions to evaluate to mark an upgrade COMPLETE. Required. "soaking": "A String", # Required. Amount of time to "soak" after a rollout has been finished before marking it COMPLETE. Cannot exceed 30 days. Required. }, + "upgradeEngine": "A String", # Output only. The effective upgrade engine for the fleet. "upstreamFleets": [ # This fleet consumes upgrades that have COMPLETE status code in the upstream fleets. See UpgradeStatus.Code for code definitions. The fleet name should be either fleet project number or id. This is defined as repeated for future proof reasons. Initial implementation will enforce at most one upstream fleet. "A String", ], @@ -2252,6 +2253,7 @@

Method Details

"postConditions": { # Post conditional checks after an upgrade has been applied on all eligible clusters. # Required. Post conditions to evaluate to mark an upgrade COMPLETE. Required. "soaking": "A String", # Required. Amount of time to "soak" after a rollout has been finished before marking it COMPLETE. Cannot exceed 30 days. Required. }, + "upgradeEngine": "A String", # Output only. The effective upgrade engine for the fleet. "upstreamFleets": [ # This fleet consumes upgrades that have COMPLETE status code in the upstream fleets. See UpgradeStatus.Code for code definitions. The fleet name should be either fleet project number or id. This is defined as repeated for future proof reasons. Initial implementation will enforce at most one upstream fleet. "A String", ], @@ -3438,6 +3440,7 @@

Method Details

"postConditions": { # Post conditional checks after an upgrade has been applied on all eligible clusters. # Required. Post conditions to evaluate to mark an upgrade COMPLETE. Required. "soaking": "A String", # Required. Amount of time to "soak" after a rollout has been finished before marking it COMPLETE. Cannot exceed 30 days. Required. }, + "upgradeEngine": "A String", # Output only. The effective upgrade engine for the fleet. "upstreamFleets": [ # This fleet consumes upgrades that have COMPLETE status code in the upstream fleets. See UpgradeStatus.Code for code definitions. The fleet name should be either fleet project number or id. This is defined as repeated for future proof reasons. Initial implementation will enforce at most one upstream fleet. "A String", ], @@ -4579,6 +4582,7 @@

Method Details

"postConditions": { # Post conditional checks after an upgrade has been applied on all eligible clusters. # Required. Post conditions to evaluate to mark an upgrade COMPLETE. Required. "soaking": "A String", # Required. Amount of time to "soak" after a rollout has been finished before marking it COMPLETE. Cannot exceed 30 days. Required. }, + "upgradeEngine": "A String", # Output only. The effective upgrade engine for the fleet. "upstreamFleets": [ # This fleet consumes upgrades that have COMPLETE status code in the upstream fleets. See UpgradeStatus.Code for code definitions. The fleet name should be either fleet project number or id. This is defined as repeated for future proof reasons. Initial implementation will enforce at most one upstream fleet. "A String", ], diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html b/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html index 1f9478921b8..bce60dff668 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.fleets.html @@ -121,7 +121,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -129,7 +129,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -236,7 +236,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -244,7 +244,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -292,7 +292,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -300,7 +300,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -356,7 +356,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -364,7 +364,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.rolloutSequences.html b/docs/dyn/gkehub_v1alpha.projects.locations.rolloutSequences.html index 6075c65afa9..c1c0d80cd3e 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.rolloutSequences.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.rolloutSequences.html @@ -130,6 +130,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. } @@ -233,6 +239,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. } @@ -278,6 +290,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. }, @@ -328,6 +346,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. } diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html b/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html index 3508a7e3396..1aaef26f094 100644 --- a/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html +++ b/docs/dyn/gkehub_v1alpha.projects.locations.rollouts.html @@ -112,26 +112,6 @@

Method Details

"deleteTime": "A String", # Output only. The timestamp at the Rollout was deleted. "displayName": "A String", # Optional. Human readable display name of the Rollout. "etag": "A String", # Output only. etag of the Rollout Ex. abc1234 - "excludedClusters": [ # Optional. Output only. The excluded clusters from the rollout. - { # An excluded cluster from the rollout. - "membership": "A String", # Output only. The name of the fleet Membership resource associated to the excluded cluster. - "reason": "A String", # Output only. The reason for excluding the cluster from the rollout. - }, - ], - "feature": { # Feature config to use for Rollout. # Optional. Feature config to use for Rollout. - "binaryAuthorizationConfig": { # BinaryAuthorizationConfig defines the fleet level configuration of binary authorization feature. # Optional. Configuration for Binary Authorization. - "evaluationMode": "A String", # Optional. Mode of operation for binauthz policy evaluation. - "policyBindings": [ # Optional. Binauthz policies that apply to this cluster. - { # Binauthz policy that applies to this cluster. - "name": "A String", # The relative resource name of the binauthz platform policy to audit. GKE platform policies have the following format: `projects/{project_number}/platforms/gke/policies/{policy_id}`. - }, - ], - }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Configuration for Security Posture. - "mode": "A String", # Sets which mode to use for Security Posture features. - "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. - }, - }, "labels": { # Optional. Labels for this Rollout. "a_key": "A String", }, @@ -152,15 +132,6 @@

Method Details

}, "name": "A String", # Identifier. The full, unique resource name of this Rollout in the format of `projects/{project}/locations/global/rollouts/{rollout}`. "rolloutSequence": "A String", # Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`. - "schedule": { # Schedule represents the schedule of the Rollout. # Output only. The schedule of the Rollout. - "waves": [ # Output only. The schedule of each wave in the Rollout. - { # WaveSchedule represents the schedule of a single rollout wave. - "waveEndTime": "A String", # Output only. The time at which the wave ends. - "waveNumber": 42, # Output only. The wave number to which this schedule applies. - "waveStartTime": "A String", # Output only. The time at which the wave starts. - }, - ], - }, "stages": [ # Output only. The stages of the Rollout. { # Stage represents a single stage in the Rollout. "endTime": "A String", # Optional. Output only. The time at which the wave ended. @@ -207,26 +178,6 @@

Method Details

"deleteTime": "A String", # Output only. The timestamp at the Rollout was deleted. "displayName": "A String", # Optional. Human readable display name of the Rollout. "etag": "A String", # Output only. etag of the Rollout Ex. abc1234 - "excludedClusters": [ # Optional. Output only. The excluded clusters from the rollout. - { # An excluded cluster from the rollout. - "membership": "A String", # Output only. The name of the fleet Membership resource associated to the excluded cluster. - "reason": "A String", # Output only. The reason for excluding the cluster from the rollout. - }, - ], - "feature": { # Feature config to use for Rollout. # Optional. Feature config to use for Rollout. - "binaryAuthorizationConfig": { # BinaryAuthorizationConfig defines the fleet level configuration of binary authorization feature. # Optional. Configuration for Binary Authorization. - "evaluationMode": "A String", # Optional. Mode of operation for binauthz policy evaluation. - "policyBindings": [ # Optional. Binauthz policies that apply to this cluster. - { # Binauthz policy that applies to this cluster. - "name": "A String", # The relative resource name of the binauthz platform policy to audit. GKE platform policies have the following format: `projects/{project_number}/platforms/gke/policies/{policy_id}`. - }, - ], - }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Configuration for Security Posture. - "mode": "A String", # Sets which mode to use for Security Posture features. - "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. - }, - }, "labels": { # Optional. Labels for this Rollout. "a_key": "A String", }, @@ -247,15 +198,6 @@

Method Details

}, "name": "A String", # Identifier. The full, unique resource name of this Rollout in the format of `projects/{project}/locations/global/rollouts/{rollout}`. "rolloutSequence": "A String", # Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`. - "schedule": { # Schedule represents the schedule of the Rollout. # Output only. The schedule of the Rollout. - "waves": [ # Output only. The schedule of each wave in the Rollout. - { # WaveSchedule represents the schedule of a single rollout wave. - "waveEndTime": "A String", # Output only. The time at which the wave ends. - "waveNumber": 42, # Output only. The wave number to which this schedule applies. - "waveStartTime": "A String", # Output only. The time at which the wave starts. - }, - ], - }, "stages": [ # Output only. The stages of the Rollout. { # Stage represents a single stage in the Rollout. "endTime": "A String", # Optional. Output only. The time at which the wave ended. diff --git a/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html b/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html index 6d1f9d6e7a4..197fd9afe3f 100644 --- a/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html +++ b/docs/dyn/gkehub_v1beta.organizations.locations.fleets.html @@ -118,7 +118,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -126,7 +126,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, diff --git a/docs/dyn/gkehub_v1beta.projects.locations.fleets.html b/docs/dyn/gkehub_v1beta.projects.locations.fleets.html index 0b3d30e6fa5..c0cf63d1fa9 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.fleets.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.fleets.html @@ -121,7 +121,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -129,7 +129,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -236,7 +236,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -244,7 +244,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -292,7 +292,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -300,7 +300,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, @@ -356,7 +356,7 @@

Method Details

}, ], }, - "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. + "compliancePostureConfig": { # Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask. "complianceStandards": [ # List of enabled compliance standards. { "standard": "A String", # Name of the compliance standard. @@ -364,7 +364,7 @@

Method Details

], "mode": "A String", # Defines the enablement mode for Compliance Posture. }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Enable/Disable Security Posture features for the cluster. + "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Enable/Disable Security Posture features for the cluster. "mode": "A String", # Sets which mode to use for Security Posture features. "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. }, diff --git a/docs/dyn/gkehub_v1beta.projects.locations.rolloutSequences.html b/docs/dyn/gkehub_v1beta.projects.locations.rolloutSequences.html index f3b32f15004..55af77cf144 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.rolloutSequences.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.rolloutSequences.html @@ -130,6 +130,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. } @@ -233,6 +239,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. } @@ -278,6 +290,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. }, @@ -328,6 +346,12 @@

Method Details

"soakDuration": "A String", # Optional. Soak time after upgrading all the clusters in the stage. }, ], + "state": { # State and reasons of the Rollout Sequence. # Output only. State of the Rollout Sequence as a whole. + "lifecycleState": "A String", # Output only. Lifecycle state of the Rollout Sequence. + "stateReasons": [ # Output only. StateReason represents the reason for the Rollout Sequence state. + "A String", + ], + }, "uid": "A String", # Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid. "updateTime": "A String", # Output only. The timestamp at which the Rollout Sequence was last updated. } diff --git a/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html b/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html index 3bc45e08e4c..8e40eff8f5e 100644 --- a/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html +++ b/docs/dyn/gkehub_v1beta.projects.locations.rollouts.html @@ -112,26 +112,6 @@

Method Details

"deleteTime": "A String", # Output only. The timestamp at the Rollout was deleted. "displayName": "A String", # Optional. Human readable display name of the Rollout. "etag": "A String", # Output only. etag of the Rollout Ex. abc1234 - "excludedClusters": [ # Optional. Output only. The excluded clusters from the rollout. - { # An excluded cluster from the rollout. - "membership": "A String", # Output only. The name of the fleet Membership resource associated to the excluded cluster. - "reason": "A String", # Output only. The reason for excluding the cluster from the rollout. - }, - ], - "feature": { # Feature config to use for Rollout. # Optional. Feature config to use for Rollout. - "binaryAuthorizationConfig": { # BinaryAuthorizationConfig defines the fleet level configuration of binary authorization feature. # Optional. Configuration for Binary Authorization. - "evaluationMode": "A String", # Optional. Mode of operation for binauthz policy evaluation. - "policyBindings": [ # Optional. Binauthz policies that apply to this cluster. - { # Binauthz policy that applies to this cluster. - "name": "A String", # The relative resource name of the binauthz platform policy to audit. GKE platform policies have the following format: `projects/{project_number}/platforms/gke/policies/{policy_id}`. - }, - ], - }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Configuration for Security Posture. - "mode": "A String", # Sets which mode to use for Security Posture features. - "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. - }, - }, "labels": { # Optional. Labels for this Rollout. "a_key": "A String", }, @@ -152,15 +132,6 @@

Method Details

}, "name": "A String", # Identifier. The full, unique resource name of this Rollout in the format of `projects/{project}/locations/global/rollouts/{rollout}`. "rolloutSequence": "A String", # Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`. - "schedule": { # Schedule represents the schedule of the Rollout. # Output only. The schedule of the Rollout. - "waves": [ # Output only. The schedule of each wave in the Rollout. - { # WaveSchedule represents the schedule of a single rollout wave. - "waveEndTime": "A String", # Output only. The time at which the wave ends. - "waveNumber": 42, # Output only. The wave number to which this schedule applies. - "waveStartTime": "A String", # Output only. The time at which the wave starts. - }, - ], - }, "stages": [ # Output only. The stages of the Rollout. { # Stage represents a single stage in the Rollout. "endTime": "A String", # Optional. Output only. The time at which the wave ended. @@ -207,26 +178,6 @@

Method Details

"deleteTime": "A String", # Output only. The timestamp at the Rollout was deleted. "displayName": "A String", # Optional. Human readable display name of the Rollout. "etag": "A String", # Output only. etag of the Rollout Ex. abc1234 - "excludedClusters": [ # Optional. Output only. The excluded clusters from the rollout. - { # An excluded cluster from the rollout. - "membership": "A String", # Output only. The name of the fleet Membership resource associated to the excluded cluster. - "reason": "A String", # Output only. The reason for excluding the cluster from the rollout. - }, - ], - "feature": { # Feature config to use for Rollout. # Optional. Feature config to use for Rollout. - "binaryAuthorizationConfig": { # BinaryAuthorizationConfig defines the fleet level configuration of binary authorization feature. # Optional. Configuration for Binary Authorization. - "evaluationMode": "A String", # Optional. Mode of operation for binauthz policy evaluation. - "policyBindings": [ # Optional. Binauthz policies that apply to this cluster. - { # Binauthz policy that applies to this cluster. - "name": "A String", # The relative resource name of the binauthz platform policy to audit. GKE platform policies have the following format: `projects/{project_number}/platforms/gke/policies/{policy_id}`. - }, - ], - }, - "securityPostureConfig": { # SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API. # Optional. Configuration for Security Posture. - "mode": "A String", # Sets which mode to use for Security Posture features. - "vulnerabilityMode": "A String", # Sets which mode to use for vulnerability scanning. - }, - }, "labels": { # Optional. Labels for this Rollout. "a_key": "A String", }, @@ -247,15 +198,6 @@

Method Details

}, "name": "A String", # Identifier. The full, unique resource name of this Rollout in the format of `projects/{project}/locations/global/rollouts/{rollout}`. "rolloutSequence": "A String", # Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`. - "schedule": { # Schedule represents the schedule of the Rollout. # Output only. The schedule of the Rollout. - "waves": [ # Output only. The schedule of each wave in the Rollout. - { # WaveSchedule represents the schedule of a single rollout wave. - "waveEndTime": "A String", # Output only. The time at which the wave ends. - "waveNumber": 42, # Output only. The wave number to which this schedule applies. - "waveStartTime": "A String", # Output only. The time at which the wave starts. - }, - ], - }, "stages": [ # Output only. The stages of the Rollout. { # Stage represents a single stage in the Rollout. "endTime": "A String", # Optional. Output only. The time at which the wave ended. diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1.json b/googleapiclient/discovery_cache/documents/gkehub.v1.json index 9bcb59e4855..6bb54f2cae4 100644 --- a/googleapiclient/discovery_cache/documents/gkehub.v1.json +++ b/googleapiclient/discovery_cache/documents/gkehub.v1.json @@ -2122,7 +2122,7 @@ } } }, -"revision": "20260126", +"revision": "20260215", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2631,7 +2631,8 @@ "type": "object" }, "CompliancePostureConfig": { -"description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", +"deprecated": true, +"description": "Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", "id": "CompliancePostureConfig", "properties": { "complianceStandards": { @@ -3736,11 +3737,12 @@ }, "compliancePostureConfig": { "$ref": "CompliancePostureConfig", -"description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." +"deprecated": true, +"description": "Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", -"description": "Enable/Disable Security Posture features for the cluster." +"description": "Optional. Enable/Disable Security Posture features for the cluster." } }, "type": "object" @@ -6264,11 +6266,17 @@ "BASIC", "ENTERPRISE" ], +"enumDeprecated": [ +false, +false, +false, +true +], "enumDescriptions": [ "Default value not specified.", "Disables Security Posture features on the cluster.", "Applies Security Posture features on the cluster.", -"Applies the Security Posture off cluster Enterprise level features." +"Deprecated: Security Posture Enterprise features are no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies the Security Posture off cluster Enterprise level features." ], "type": "string" }, @@ -6280,10 +6288,16 @@ "VULNERABILITY_BASIC", "VULNERABILITY_ENTERPRISE" ], +"enumDeprecated": [ +false, +false, +true, +false +], "enumDescriptions": [ "Default value not specified.", "Disables vulnerability scanning on the cluster.", -"Applies basic vulnerability scanning on the cluster.", +"Deprecated: Basic vulnerability scanning is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies basic vulnerability scanning on the cluster.", "Applies the Security Posture's vulnerability on cluster Enterprise level features." ], "type": "string" diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json index c0096c4f888..d27c7427be3 100644 --- a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json @@ -2498,7 +2498,7 @@ } } }, -"revision": "20260126", +"revision": "20260215", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2734,6 +2734,21 @@ "$ref": "ClusterUpgradePostConditions", "description": "Required. Post conditions to evaluate to mark an upgrade COMPLETE. Required." }, +"upgradeEngine": { +"description": "Output only. The effective upgrade engine for the fleet.", +"enum": [ +"UPGRADE_ENGINE_UNSPECIFIED", +"SEQUENCING_V1", +"SEQUENCING_V2" +], +"enumDescriptions": [ +"Default value.", +"Upgrades are managed using fleet-based rollout sequencing.", +"Upgrades are managed using rollout sequencing with custom stages." +], +"readOnly": true, +"type": "string" +}, "upstreamFleets": { "description": "This fleet consumes upgrades that have COMPLETE status code in the upstream fleets. See UpgradeStatus.Code for code definitions. The fleet name should be either fleet project number or id. This is defined as repeated for future proof reasons. Initial implementation will enforce at most one upstream fleet.", "items": { @@ -3134,7 +3149,8 @@ "type": "object" }, "CompliancePostureConfig": { -"description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", +"deprecated": true, +"description": "Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", "id": "CompliancePostureConfig", "properties": { "complianceStandards": { @@ -4300,11 +4316,12 @@ }, "compliancePostureConfig": { "$ref": "CompliancePostureConfig", -"description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." +"deprecated": true, +"description": "Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", -"description": "Enable/Disable Security Posture features for the cluster." +"description": "Optional. Enable/Disable Security Posture features for the cluster." } }, "type": "object" @@ -4326,35 +4343,6 @@ "properties": {}, "type": "object" }, -"ExcludedCluster": { -"description": "An excluded cluster from the rollout.", -"id": "ExcludedCluster", -"properties": { -"membership": { -"description": "Output only. The name of the fleet Membership resource associated to the excluded cluster.", -"readOnly": true, -"type": "string" -}, -"reason": { -"description": "Output only. The reason for excluding the cluster from the rollout.", -"enum": [ -"REASON_UNSPECIFIED", -"EXCLUDED_BY_FILTER", -"ALREADY_UPGRADED", -"VERSION_TOO_OLD" -], -"enumDescriptions": [ -"Default value.", -"The cluster was excluded by the rollout filter.", -"The cluster was already upgraded.", -"The cluster version is too old." -], -"readOnly": true, -"type": "string" -} -}, -"type": "object" -}, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() < 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -4559,21 +4547,6 @@ }, "type": "object" }, -"FeatureUpdate": { -"description": "Feature config to use for Rollout.", -"id": "FeatureUpdate", -"properties": { -"binaryAuthorizationConfig": { -"$ref": "BinaryAuthorizationConfig", -"description": "Optional. Configuration for Binary Authorization." -}, -"securityPostureConfig": { -"$ref": "SecurityPostureConfig", -"description": "Optional. Configuration for Security Posture." -} -}, -"type": "object" -}, "Fleet": { "description": "Fleet contains the Fleet-wide metadata and configuration.", "id": "Fleet", @@ -7011,18 +6984,6 @@ "readOnly": true, "type": "string" }, -"excludedClusters": { -"description": "Optional. Output only. The excluded clusters from the rollout.", -"items": { -"$ref": "ExcludedCluster" -}, -"readOnly": true, -"type": "array" -}, -"feature": { -"$ref": "FeatureUpdate", -"description": "Optional. Feature config to use for Rollout." -}, "labels": { "additionalProperties": { "type": "string" @@ -7046,11 +7007,6 @@ "description": "Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`.", "type": "string" }, -"schedule": { -"$ref": "Schedule", -"description": "Output only. The schedule of the Rollout.", -"readOnly": true -}, "stages": { "description": "Output only. The stages of the Rollout.", "items": { @@ -7066,16 +7022,14 @@ "RUNNING", "PAUSED", "CANCELLED", -"COMPLETED", -"SCHEDULED" +"COMPLETED" ], "enumDescriptions": [ "Unspecified state.", "The Rollout is running.", "The Rollout is paused.", "The Rollout is in a failure terminal state.", -"The Rollout is in a terminal state.", -"The Rollout is scheduled to start." +"The Rollout is in a terminal state." ], "readOnly": true, "type": "string" @@ -7173,6 +7127,11 @@ }, "type": "array" }, +"state": { +"$ref": "RolloutSequenceState", +"description": "Output only. State of the Rollout Sequence as a whole.", +"readOnly": true +}, "uid": { "description": "Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid.", "readOnly": true, @@ -7187,6 +7146,54 @@ }, "type": "object" }, +"RolloutSequenceState": { +"description": "State and reasons of the Rollout Sequence.", +"id": "RolloutSequenceState", +"properties": { +"lifecycleState": { +"description": "Output only. Lifecycle state of the Rollout Sequence.", +"enum": [ +"LIFECYCLE_STATE_UNSPECIFIED", +"LIFECYCLE_STATE_ACTIVE", +"LIFECYCLE_STATE_WARNING", +"LIFECYCLE_STATE_ERROR" +], +"enumDescriptions": [ +"The default value. This value is used if the state is omitted.", +"The Rollout Sequence is active.", +"The Rollout Sequence has warnings.", +"The Rollout Sequence has errors." +], +"readOnly": true, +"type": "string" +}, +"stateReasons": { +"description": "Output only. StateReason represents the reason for the Rollout Sequence state.", +"items": { +"enum": [ +"STATE_REASON_UNSPECIFIED", +"FLEET_FEATURE_DELETED_ERROR", +"FLEET_DELETED_ERROR", +"EMPTY_STAGE_WARNING", +"MIXED_RELEASE_CHANNELS_WARNING", +"INTERNAL_ERROR" +], +"enumDescriptions": [ +"Default unspecified value.", +"A fleet feature is deleted.", +"A fleet is deleted.", +"A stage is empty.", +"Mixed release channels in the sequence.", +"Internal error, for example when host project is soft-deleted." +], +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, "RolloutStage": { "description": "Stage represents a single stage in the Rollout.", "id": "RolloutStage", @@ -7290,21 +7297,6 @@ }, "type": "object" }, -"Schedule": { -"description": "Schedule represents the schedule of the Rollout.", -"id": "Schedule", -"properties": { -"waves": { -"description": "Output only. The schedule of each wave in the Rollout.", -"items": { -"$ref": "WaveSchedule" -}, -"readOnly": true, -"type": "array" -} -}, -"type": "object" -}, "Scope": { "description": "Scope represents a Scope in a Fleet.", "id": "Scope", @@ -7423,11 +7415,17 @@ "BASIC", "ENTERPRISE" ], +"enumDeprecated": [ +false, +false, +false, +true +], "enumDescriptions": [ "Default value not specified.", "Disables Security Posture features on the cluster.", "Applies Security Posture features on the cluster.", -"Applies the Security Posture off cluster Enterprise level features." +"Deprecated: Security Posture Enterprise features are no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies the Security Posture off cluster Enterprise level features." ], "type": "string" }, @@ -7439,10 +7437,16 @@ "VULNERABILITY_BASIC", "VULNERABILITY_ENTERPRISE" ], +"enumDeprecated": [ +false, +false, +true, +false +], "enumDescriptions": [ "Default value not specified.", "Disables vulnerability scanning on the cluster.", -"Applies basic vulnerability scanning on the cluster.", +"Deprecated: Basic vulnerability scanning is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies basic vulnerability scanning on the cluster.", "Applies the Security Posture's vulnerability on cluster Enterprise level features." ], "type": "string" @@ -8250,45 +8254,18 @@ "enum": [ "TYPE_UNSPECIFIED", "TYPE_CONTROL_PLANE", -"TYPE_NODE_POOL", -"TYPE_CONFIG_SYNC" +"TYPE_NODE_POOL" ], "enumDescriptions": [ "Default value.", "Control plane upgrade.", -"Node pool upgrade.", -"Config Sync upgrade." +"Node pool upgrade." ], "type": "string" } }, "type": "object" }, -"WaveSchedule": { -"description": "WaveSchedule represents the schedule of a single rollout wave.", -"id": "WaveSchedule", -"properties": { -"waveEndTime": { -"description": "Output only. The time at which the wave ends.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -}, -"waveNumber": { -"description": "Output only. The wave number to which this schedule applies.", -"format": "int32", -"readOnly": true, -"type": "integer" -}, -"waveStartTime": { -"description": "Output only. The time at which the wave starts.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -} -}, -"type": "object" -}, "WorkloadIdentityFeatureSpec": { "description": "**WorkloadIdentity**: Global feature specification.", "id": "WorkloadIdentityFeatureSpec", diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json index ccba9cdd009..b952e17fd2b 100644 --- a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json +++ b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json @@ -2354,7 +2354,7 @@ } } }, -"revision": "20260126", +"revision": "20260215", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2874,7 +2874,8 @@ "type": "object" }, "CompliancePostureConfig": { -"description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", +"deprecated": true, +"description": "Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", "id": "CompliancePostureConfig", "properties": { "complianceStandards": { @@ -4040,11 +4041,12 @@ }, "compliancePostureConfig": { "$ref": "CompliancePostureConfig", -"description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." +"deprecated": true, +"description": "Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", -"description": "Enable/Disable Security Posture features for the cluster." +"description": "Optional. Enable/Disable Security Posture features for the cluster." } }, "type": "object" @@ -4066,35 +4068,6 @@ "properties": {}, "type": "object" }, -"ExcludedCluster": { -"description": "An excluded cluster from the rollout.", -"id": "ExcludedCluster", -"properties": { -"membership": { -"description": "Output only. The name of the fleet Membership resource associated to the excluded cluster.", -"readOnly": true, -"type": "string" -}, -"reason": { -"description": "Output only. The reason for excluding the cluster from the rollout.", -"enum": [ -"REASON_UNSPECIFIED", -"EXCLUDED_BY_FILTER", -"ALREADY_UPGRADED", -"VERSION_TOO_OLD" -], -"enumDescriptions": [ -"Default value.", -"The cluster was excluded by the rollout filter.", -"The cluster was already upgraded.", -"The cluster version is too old." -], -"readOnly": true, -"type": "string" -} -}, -"type": "object" -}, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() < 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -4270,21 +4243,6 @@ }, "type": "object" }, -"FeatureUpdate": { -"description": "Feature config to use for Rollout.", -"id": "FeatureUpdate", -"properties": { -"binaryAuthorizationConfig": { -"$ref": "BinaryAuthorizationConfig", -"description": "Optional. Configuration for Binary Authorization." -}, -"securityPostureConfig": { -"$ref": "SecurityPostureConfig", -"description": "Optional. Configuration for Security Posture." -} -}, -"type": "object" -}, "Fleet": { "description": "Fleet contains the Fleet-wide metadata and configuration.", "id": "Fleet", @@ -6635,18 +6593,6 @@ "readOnly": true, "type": "string" }, -"excludedClusters": { -"description": "Optional. Output only. The excluded clusters from the rollout.", -"items": { -"$ref": "ExcludedCluster" -}, -"readOnly": true, -"type": "array" -}, -"feature": { -"$ref": "FeatureUpdate", -"description": "Optional. Feature config to use for Rollout." -}, "labels": { "additionalProperties": { "type": "string" @@ -6670,11 +6616,6 @@ "description": "Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`.", "type": "string" }, -"schedule": { -"$ref": "Schedule", -"description": "Output only. The schedule of the Rollout.", -"readOnly": true -}, "stages": { "description": "Output only. The stages of the Rollout.", "items": { @@ -6690,16 +6631,14 @@ "RUNNING", "PAUSED", "CANCELLED", -"COMPLETED", -"SCHEDULED" +"COMPLETED" ], "enumDescriptions": [ "Unspecified state.", "The Rollout is running.", "The Rollout is paused.", "The Rollout is in a failure terminal state.", -"The Rollout is in a terminal state.", -"The Rollout is scheduled to start." +"The Rollout is in a terminal state." ], "readOnly": true, "type": "string" @@ -6797,6 +6736,11 @@ }, "type": "array" }, +"state": { +"$ref": "RolloutSequenceState", +"description": "Output only. State of the Rollout Sequence as a whole.", +"readOnly": true +}, "uid": { "description": "Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid.", "readOnly": true, @@ -6811,6 +6755,54 @@ }, "type": "object" }, +"RolloutSequenceState": { +"description": "State and reasons of the Rollout Sequence.", +"id": "RolloutSequenceState", +"properties": { +"lifecycleState": { +"description": "Output only. Lifecycle state of the Rollout Sequence.", +"enum": [ +"LIFECYCLE_STATE_UNSPECIFIED", +"LIFECYCLE_STATE_ACTIVE", +"LIFECYCLE_STATE_WARNING", +"LIFECYCLE_STATE_ERROR" +], +"enumDescriptions": [ +"The default value. This value is used if the state is omitted.", +"The Rollout Sequence is active.", +"The Rollout Sequence has warnings.", +"The Rollout Sequence has errors." +], +"readOnly": true, +"type": "string" +}, +"stateReasons": { +"description": "Output only. StateReason represents the reason for the Rollout Sequence state.", +"items": { +"enum": [ +"STATE_REASON_UNSPECIFIED", +"FLEET_FEATURE_DELETED_ERROR", +"FLEET_DELETED_ERROR", +"EMPTY_STAGE_WARNING", +"MIXED_RELEASE_CHANNELS_WARNING", +"INTERNAL_ERROR" +], +"enumDescriptions": [ +"Default unspecified value.", +"A fleet feature is deleted.", +"A fleet is deleted.", +"A stage is empty.", +"Mixed release channels in the sequence.", +"Internal error, for example when host project is soft-deleted." +], +"type": "string" +}, +"readOnly": true, +"type": "array" +} +}, +"type": "object" +}, "RolloutStage": { "description": "Stage represents a single stage in the Rollout.", "id": "RolloutStage", @@ -6914,21 +6906,6 @@ }, "type": "object" }, -"Schedule": { -"description": "Schedule represents the schedule of the Rollout.", -"id": "Schedule", -"properties": { -"waves": { -"description": "Output only. The schedule of each wave in the Rollout.", -"items": { -"$ref": "WaveSchedule" -}, -"readOnly": true, -"type": "array" -} -}, -"type": "object" -}, "Scope": { "description": "Scope represents a Scope in a Fleet.", "id": "Scope", @@ -7038,11 +7015,17 @@ "BASIC", "ENTERPRISE" ], +"enumDeprecated": [ +false, +false, +false, +true +], "enumDescriptions": [ "Default value not specified.", "Disables Security Posture features on the cluster.", "Applies Security Posture features on the cluster.", -"Applies the Security Posture off cluster Enterprise level features." +"Deprecated: Security Posture Enterprise features are no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies the Security Posture off cluster Enterprise level features." ], "type": "string" }, @@ -7054,10 +7037,16 @@ "VULNERABILITY_BASIC", "VULNERABILITY_ENTERPRISE" ], +"enumDeprecated": [ +false, +false, +true, +false +], "enumDescriptions": [ "Default value not specified.", "Disables vulnerability scanning on the cluster.", -"Applies basic vulnerability scanning on the cluster.", +"Deprecated: Basic vulnerability scanning is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies basic vulnerability scanning on the cluster.", "Applies the Security Posture's vulnerability on cluster Enterprise level features." ], "type": "string" @@ -7521,45 +7510,18 @@ "enum": [ "TYPE_UNSPECIFIED", "TYPE_CONTROL_PLANE", -"TYPE_NODE_POOL", -"TYPE_CONFIG_SYNC" +"TYPE_NODE_POOL" ], "enumDescriptions": [ "Default value.", "Control plane upgrade.", -"Node pool upgrade.", -"Config Sync upgrade." +"Node pool upgrade." ], "type": "string" } }, "type": "object" }, -"WaveSchedule": { -"description": "WaveSchedule represents the schedule of a single rollout wave.", -"id": "WaveSchedule", -"properties": { -"waveEndTime": { -"description": "Output only. The time at which the wave ends.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -}, -"waveNumber": { -"description": "Output only. The wave number to which this schedule applies.", -"format": "int32", -"readOnly": true, -"type": "integer" -}, -"waveStartTime": { -"description": "Output only. The time at which the wave starts.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -} -}, -"type": "object" -}, "WorkloadIdentityFeatureSpec": { "description": "**WorkloadIdentity**: Global feature specification.", "id": "WorkloadIdentityFeatureSpec", From c157813b93b95fa3aab1ca25675d218e75f27812 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 16/29] feat(healthcare): update the api #### healthcare:v1 The following keys were added: - resources.projects.resources.locations.resources.datasets.resources.fhirStores.methods.bulkDelete (Total Keys: 12) - schemas.BulkDeleteResourcesRequest (Total Keys: 6) #### healthcare:v1beta1 The following keys were added: - resources.projects.resources.locations.resources.datasets.resources.fhirStores.methods.bulkDelete (Total Keys: 12) - schemas.BulkDeleteResourcesRequest (Total Keys: 6) --- ...ojects.locations.datasets.dicomStores.html | 4 +- ...rojects.locations.datasets.fhirStores.html | 52 ++++++++++++- .../dyn/healthcare_v1.projects.locations.html | 4 +- ...ojects.locations.datasets.dicomStores.html | 4 +- ...rojects.locations.datasets.fhirStores.html | 52 ++++++++++++- ...healthcare_v1beta1.projects.locations.html | 4 +- .../documents/healthcare.v1.json | 74 +++++++++++++++++-- .../documents/healthcare.v1beta1.json | 74 +++++++++++++++++-- 8 files changed, 248 insertions(+), 20 deletions(-) diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html b/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html index 3a82f5423f3..4d2b97feebc 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.dicomStores.html @@ -328,7 +328,7 @@

Method Details

}, "useRegionalDataProcessing": True or False, # Optional. Ensures in-flight data remains in the region of origin during de-identification. The default value is false. Using this option results in a significant reduction of throughput, and is not compatible with `LOCATION` or `ORGANIZATION_NAME` infoTypes. `LOCATION` must be excluded within TextConfig, and must also be excluded within ImageConfig if image redaction is required. }, - "destinationStore": "A String", # Required. The name of the DICOM store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination DICOM store must not exist. * The caller must have the necessary permissions to create the destination DICOM store. + "destinationStore": "A String", # Required. The name of the DICOM store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset and DICOM store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.dicomStores.dicomWebWrite permission to write to the destination DICOM store. "filterConfig": { # Specifies the filter configuration for DICOM resources. # Filter configuration. "resourcePathsGcsUri": "A String", # The Cloud Storage location of the filter configuration file. The `gcs_uri` must be in the format `gs://bucket/path/to/object`. The filter configuration file must contain a list of resource paths separated by newline characters (\n or \r\n). Each resource path must be in the format "/studies/{studyUID}[/series/{seriesUID}[/instances/{instanceUID}]]" The Cloud Healthcare API service account must have the `roles/storage.objectViewer` Cloud IAM role for this Cloud Storage location. }, @@ -403,7 +403,7 @@

Method Details

"writeDisposition": "A String", # Optional. Determines whether the existing table in the destination is to be overwritten or appended to. If a write_disposition is specified, the `force` parameter is ignored. }, "gcsDestination": { # The Cloud Storage location where the server writes the output and the export configuration. # The Cloud Storage output destination. The Cloud Healthcare Service Agent requires the `roles/storage.objectAdmin` Cloud IAM roles on the Cloud Storage location. - "mimeType": "A String", # MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in. + "mimeType": "A String", # MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 (DICOM Deflated Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with embedded JPEG Extended) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with embedded JPEG Lossless First-Order Prediction) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with embedded High-Throughput JPEG 2000 Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput JPEG 2000 with RPCL Options Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM with embedded RLE Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in. "uriPrefix": "A String", # The Cloud Storage destination to export to. URI for a Cloud Storage directory where the server writes the result files, in the format `gs://{bucket-id}/{path/to/destination/dir}`). If there is no trailing slash, the service appends one when composing the object path. The user is responsible for creating the Cloud Storage bucket referenced in `uri_prefix`. }, } diff --git a/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html b/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html index 52ace90e8ec..90d66bacca2 100644 --- a/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html +++ b/docs/dyn/healthcare_v1.projects.locations.datasets.fhirStores.html @@ -90,6 +90,9 @@

Instance Methods

applyConsents(name, body=None, x__xgafv=None)

Apply the Consent resources for the FHIR store and reindex the underlying resources in the FHIR store according to the aggregate consent. The aggregate consent of the patient in scope in this request replaces any previous call of this method. Any Consent resource change after this operation execution (including deletion) requires you to call ApplyConsents again to have effect. This method returns an Operation that can be used to track the progress of the consent resources that were processed by calling GetOperation. Upon completion, the ApplyConsentsResponse additionally contains the number of resources that was reindexed. Errors are logged to Cloud Logging (see [Viewing error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging)). To enforce consent check for data access, `consent_config.access_enforced` must be set to true for the FhirStore. FHIR Consent is not supported in DSTU2 or R5.

+

+ bulkDelete(name, body=None, x__xgafv=None)

+

Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.

bulk_export_group(name, organizeOutputBy=None, outputFormat=None, x__xgafv=None, x_since=None, x_type=None)

Bulk exports a Group resource and resources in the member field, including related resources for each Patient member. The export for each Patient is identical to a GetPatientEverything request. Implements the FHIR implementation guide [$export group of patients](https://build.fhir.org/ig/HL7/bulk-data/export.html#endpoint---group-of-patients). The following headers must be set in the request: * `Accept`: specifies the format of the `OperationOutcome` response. Only `application/fhir+json` is supported. * `Prefer`: specifies whether the response is immediate or asynchronous. Must be to `respond-async` because only asynchronous responses are supported. Specify the destination for the server to write result files by setting the Cloud Storage location bulk_export_gcs_destination on the FHIR store. URI of an existing Cloud Storage directory where the server writes result files, in the format gs://{bucket-id}/{path/to/destination/dir}. If there is no trailing slash, the service appends one when composing the object path. The user is responsible for creating the Cloud Storage bucket referenced. Supports the following query parameters: * `_type`: string of comma-delimited FHIR resource types. If provided, only resources of the specified type(s) are exported. * `_since`: if provided, only resources updated after the specified time are exported. * `_outputFormat`: optional, specify ndjson to export data in NDJSON format. Exported file names use the format: {export_id}_{resource_type}.ndjson. * `organizeOutputBy`: resource type to organize the output by. Required and must be set to `Patient`. When specified, output files are organized by instances of the specified resource type, including the resource, referenced resources, and resources that contain references to that resource. On success, the `Content-Location` header of response is set to a URL that you can use to query the status of the export. The URL is in the format `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/operations/{export_id}`. See get-fhir-operation-status for more information. Errors generated by the FHIR store contain a JSON-encoded `OperationOutcome` resource describing the reason for the error.

@@ -240,6 +243,53 @@

Method Details

} +
+ bulkDelete(name, body=None, x__xgafv=None) +
Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.
+
+Args:
+  name: string, Required. The name of the FHIR store to bulk delete resources from, in the format of `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to bulk delete FHIR resources.
+  "gcsDestination": { # The configuration for exporting to Cloud Storage. # Optional. The Cloud Storage output destination. The Healthcare Service Agent account requires the `roles/storage.objectAdmin` role on the Cloud Storage location. The deleted resources outputs are organized by FHIR resource types. The server creates one or more objects per resource type. Each object contains newline delimited strings in the format {resourceType}/{resourceId}.
+    "uriPrefix": "A String", # URI for a Cloud Storage directory where result files should be written, in the format of `gs://{bucket-id}/{path/to/destination/dir}`. If there is no trailing slash, the service appends one when composing the object path. The user is responsible for creating the Cloud Storage bucket referenced in `uri_prefix`.
+  },
+  "type": "A String", # Optional. String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) will be deleted.
+  "until": "A String", # Optional. If provided, only resources updated before or atthis time are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time must be specified to the second and include a time zone.
+  "versionConfig": "A String", # Optional. Specifies which version of the resources to delete.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # This resource represents a long-running operation that is the result of a network API call.
+  "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+  "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+      {
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+    ],
+    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+  },
+  "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+  "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+  "response": { # 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`.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+}
+
+
bulk_export_group(name, organizeOutputBy=None, outputFormat=None, x__xgafv=None, x_since=None, x_type=None)
Bulk exports a Group resource and resources in the member field, including related resources for each Patient member. The export for each Patient is identical to a GetPatientEverything request. Implements the FHIR implementation guide [$export group of patients](https://build.fhir.org/ig/HL7/bulk-data/export.html#endpoint---group-of-patients). The following headers must be set in the request: * `Accept`: specifies the format of the `OperationOutcome` response. Only `application/fhir+json` is supported. * `Prefer`: specifies whether the response is immediate or asynchronous. Must be to `respond-async` because only asynchronous responses are supported. Specify the destination for the server to write result files by setting the Cloud Storage location bulk_export_gcs_destination on the FHIR store. URI of an existing Cloud Storage directory where the server writes result files, in the format gs://{bucket-id}/{path/to/destination/dir}. If there is no trailing slash, the service appends one when composing the object path. The user is responsible for creating the Cloud Storage bucket referenced. Supports the following query parameters: * `_type`: string of comma-delimited FHIR resource types. If provided, only resources of the specified type(s) are exported. * `_since`: if provided, only resources updated after the specified time are exported. * `_outputFormat`: optional, specify ndjson to export data in NDJSON format. Exported file names use the format: {export_id}_{resource_type}.ndjson. * `organizeOutputBy`: resource type to organize the output by. Required and must be set to `Patient`. When specified, output files are organized by instances of the specified resource type, including the resource, referenced resources, and resources that contain references to that resource. On success, the `Content-Location` header of response is set to a URL that you can use to query the status of the export. The URL is in the format `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/operations/{export_id}`. See get-fhir-operation-status for more information. Errors generated by the FHIR store contain a JSON-encoded `OperationOutcome` resource describing the reason for the error.
@@ -725,7 +775,7 @@ 

Method Details

}, "useRegionalDataProcessing": True or False, # Optional. Ensures in-flight data remains in the region of origin during de-identification. The default value is false. Using this option results in a significant reduction of throughput, and is not compatible with `LOCATION` or `ORGANIZATION_NAME` infoTypes. `LOCATION` must be excluded within TextConfig, and must also be excluded within ImageConfig if image redaction is required. }, - "destinationStore": "A String", # Required. The name of the FHIR store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination FHIR store must exist. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store. + "destinationStore": "A String", # Required. The name of the FHIR store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store. "gcsConfigUri": "A String", # Cloud Storage location to read the JSON cloud.healthcare.deidentify.DeidentifyConfig from, overriding the default config. Must be of the form `gs://{bucket_id}/path/to/object`. The Cloud Storage location must grant the Cloud IAM role `roles/storage.objectViewer` to the project's Cloud Healthcare Service Agent service account. Only one of `config` and `gcs_config_uri` can be specified. "resourceFilter": { # Filter configuration. # A filter specifying the resources to include in the output. If not specified, all resources are included in the output. "resources": { # A list of FHIR resources. # List of resources to include in the output. If this list is empty or not specified, all resources are included in the output. diff --git a/docs/dyn/healthcare_v1.projects.locations.html b/docs/dyn/healthcare_v1.projects.locations.html index 015d2b6f34e..40fadfc7fd9 100644 --- a/docs/dyn/healthcare_v1.projects.locations.html +++ b/docs/dyn/healthcare_v1.projects.locations.html @@ -92,7 +92,7 @@

Instance Methods

Gets information about a location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -131,7 +131,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html
index dcf83369556..38850112a9d 100644
--- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html
+++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.dicomStores.html
@@ -439,7 +439,7 @@ 

Method Details

}, "useRegionalDataProcessing": True or False, # Ensures in-flight data remains in the region of origin during de-identification. The default value is false. Using this option results in a significant reduction of throughput, and is not compatible with `LOCATION` or `ORGANIZATION_NAME` infoTypes. If the deprecated DicomConfig or FhirConfig are used, then `LOCATION` must be excluded within TextConfig, and must also be excluded within ImageConfig if image redaction is required. }, - "destinationStore": "A String", # Required. The name of the DICOM store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination DICOM store must not exist. * The caller must have the necessary permissions to create the destination DICOM store. + "destinationStore": "A String", # Required. The name of the DICOM store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset and DICOM store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.dicomStores.dicomWebWrite permission to write to the destination DICOM store. "filterConfig": { # Specifies the filter configuration for DICOM resources. # Filter configuration. "resourcePathsGcsUri": "A String", # The Cloud Storage location of the filter configuration file. The `gcs_uri` must be in the format `gs://bucket/path/to/object`. The filter configuration file must contain a list of resource paths separated by newline characters (\n or \r\n). Each resource path must be in the format "/studies/{studyUID}[/series/{seriesUID}[/instances/{instanceUID}]]" The Cloud Healthcare API service account must have the `roles/storage.objectViewer` Cloud IAM role for this Cloud Storage location. }, @@ -519,7 +519,7 @@

Method Details

"resourcePathsGcsUri": "A String", # The Cloud Storage location of the filter configuration file. The `gcs_uri` must be in the format `gs://bucket/path/to/object`. The filter configuration file must contain a list of resource paths separated by newline characters (\n or \r\n). Each resource path must be in the format "/studies/{studyUID}[/series/{seriesUID}[/instances/{instanceUID}]]" The Cloud Healthcare API service account must have the `roles/storage.objectViewer` Cloud IAM role for this Cloud Storage location. }, "gcsDestination": { # The Cloud Storage location where the server writes the output and the export configuration. # The Cloud Storage output destination. The Cloud Healthcare Service Agent requires the `roles/storage.objectAdmin` Cloud IAM roles on the Cloud Storage location. - "mimeType": "A String", # MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000)h - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in. + "mimeType": "A String", # MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 (DICOM Deflated Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with embedded JPEG Extended) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with embedded JPEG Lossless First-Order Prediction) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with embedded High-Throughput JPEG 2000 Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput JPEG 2000 with RPCL Options Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM with embedded RLE Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in. "uriPrefix": "A String", # The Cloud Storage destination to export to. URI for a Cloud Storage directory where the server writes the result files, in the format `gs://{bucket-id}/{path/to/destination/dir}`). If there is no trailing slash, the service appends one when composing the object path. The user is responsible for creating the Cloud Storage bucket referenced in `uri_prefix`. }, } diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html index 0a56275f619..e7f35c51bce 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.datasets.fhirStores.html @@ -90,6 +90,9 @@

Instance Methods

applyConsents(name, body=None, x__xgafv=None)

Apply the Consent resources for the FHIR store and reindex the underlying resources in the FHIR store according to the aggregate consent. The aggregate consent of the patient in scope in this request replaces any previous call of this method. Any Consent resource change after this operation execution (including deletion) requires you to call ApplyConsents again to have effect. This method returns an Operation that can be used to track the progress of the consent resources that were processed by calling GetOperation. Upon completion, the ApplyConsentsResponse additionally contains the number of resources that was reindexed. Errors are logged to Cloud Logging (see [Viewing error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging)). To enforce consent check for data access, `consent_config.access_enforced` must be set to true for the FhirStore. FHIR Consent is not supported in DSTU2 or R5.

+

+ bulkDelete(name, body=None, x__xgafv=None)

+

Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.

bulk_export_group(name, organizeOutputBy=None, outputFormat=None, x__xgafv=None, x_since=None, x_type=None)

Bulk exports a Group resource and resources in the member field, including related resources for each Patient member. The export for each Patient is identical to a GetPatientEverything request. Implements the FHIR implementation guide [$export group of patients](https://build.fhir.org/ig/HL7/bulk-data/export.html#endpoint---group-of-patients). The following headers must be set in the request: * `Accept`: specifies the format of the `OperationOutcome` response. Only `application/fhir+json` is supported. * `Prefer`: specifies whether the response is immediate or asynchronous. Must be to `respond-async` because only asynchronous responses are supported. Specify the destination for the server to write result files by setting the Cloud Storage location bulk_export_gcs_destination on the FHIR store. URI of an existing Cloud Storage directory where the server writes result files, in the format gs://{bucket-id}/{path/to/destination/dir}. If there is no trailing slash, the service appends one when composing the object path. The user is responsible for creating the Cloud Storage bucket referenced. Supports the following query parameters: * `_type`: string of comma-delimited FHIR resource types. If provided, only resources of the specified type(s) are exported. * `_since`: if provided, only resources updated after the specified time are exported. * `_outputFormat`: optional, specify ndjson to export data in NDJSON format. Exported file names use the format: {export_id}_{resource_type}.ndjson. * `organizeOutputBy`: resource type to organize the output by. Required and must be set to `Patient`. When specified, output files are organized by instances of the specified resource type, including the resource, referenced resources, and resources that contain references to that resource. On success, the `Content-Location` header of response is set to a URL that you can use to query the status of the export. The URL is in the format `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/operations/{export_id}`. See get-fhir-operation-status for more information. Errors generated by the FHIR store contain a JSON-encoded `OperationOutcome` resource describing the reason for the error.

@@ -249,6 +252,53 @@

Method Details

}
+
+ bulkDelete(name, body=None, x__xgafv=None) +
Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.
+
+Args:
+  name: string, Required. The name of the FHIR store to bulk delete resources from, in the format of `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to bulk delete FHIR resources.
+  "gcsDestination": { # The configuration for exporting to Cloud Storage. # Optional. The Cloud Storage output destination. The Healthcare Service Agent account requires the `roles/storage.objectAdmin` role on the Cloud Storage location. The deleted resources outputs are organized by FHIR resource types. The server creates one or more objects per resource type. Each object contains newline delimited strings in the format {resourceType}/{resourceId}.
+    "uriPrefix": "A String", # URI for a Cloud Storage directory where result files should be written (in the format `gs://{bucket-id}/{path/to/destination/dir}`). If there is no trailing slash, the service appends one when composing the object path. The Cloud Storage bucket referenced in `uri_prefix` must exist or an error occurs.
+  },
+  "type": "A String", # Optional. String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) will be deleted.
+  "until": "A String", # Optional. If provided, only resources updated before or atthis time are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time must be specified to the second and include a time zone.
+  "versionConfig": "A String", # Optional. Specifies which version of the resources to delete.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # This resource represents a long-running operation that is the result of a network API call.
+  "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+  "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+      {
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+    ],
+    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+  },
+  "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+  "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+  "response": { # 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`.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+}
+
+
bulk_export_group(name, organizeOutputBy=None, outputFormat=None, x__xgafv=None, x_since=None, x_type=None)
Bulk exports a Group resource and resources in the member field, including related resources for each Patient member. The export for each Patient is identical to a GetPatientEverything request. Implements the FHIR implementation guide [$export group of patients](https://build.fhir.org/ig/HL7/bulk-data/export.html#endpoint---group-of-patients). The following headers must be set in the request: * `Accept`: specifies the format of the `OperationOutcome` response. Only `application/fhir+json` is supported. * `Prefer`: specifies whether the response is immediate or asynchronous. Must be to `respond-async` because only asynchronous responses are supported. Specify the destination for the server to write result files by setting the Cloud Storage location bulk_export_gcs_destination on the FHIR store. URI of an existing Cloud Storage directory where the server writes result files, in the format gs://{bucket-id}/{path/to/destination/dir}. If there is no trailing slash, the service appends one when composing the object path. The user is responsible for creating the Cloud Storage bucket referenced. Supports the following query parameters: * `_type`: string of comma-delimited FHIR resource types. If provided, only resources of the specified type(s) are exported. * `_since`: if provided, only resources updated after the specified time are exported. * `_outputFormat`: optional, specify ndjson to export data in NDJSON format. Exported file names use the format: {export_id}_{resource_type}.ndjson. * `organizeOutputBy`: resource type to organize the output by. Required and must be set to `Patient`. When specified, output files are organized by instances of the specified resource type, including the resource, referenced resources, and resources that contain references to that resource. On success, the `Content-Location` header of response is set to a URL that you can use to query the status of the export. The URL is in the format `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}/operations/{export_id}`. See get-fhir-operation-status for more information. Errors generated by the FHIR store contain a JSON-encoded `OperationOutcome` resource describing the reason for the error.
@@ -1115,7 +1165,7 @@ 

Method Details

}, "useRegionalDataProcessing": True or False, # Ensures in-flight data remains in the region of origin during de-identification. The default value is false. Using this option results in a significant reduction of throughput, and is not compatible with `LOCATION` or `ORGANIZATION_NAME` infoTypes. If the deprecated DicomConfig or FhirConfig are used, then `LOCATION` must be excluded within TextConfig, and must also be excluded within ImageConfig if image redaction is required. }, - "destinationStore": "A String", # Required. The name of the FHIR store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination FHIR store must exist. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store. + "destinationStore": "A String", # Required. The name of the FHIR store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store. "gcsConfigUri": "A String", # Cloud Storage location to read the JSON cloud.healthcare.deidentify.DeidentifyConfig from, overriding the default config. Must be of the form `gs://{bucket_id}/path/to/object`. The Cloud Storage location must grant the Cloud IAM role `roles/storage.objectViewer` to the project's Cloud Healthcare Service Agent service account. Only one of `config` and `gcs_config_uri` can be specified. "resourceFilter": { # Filter configuration. # A filter specifying the resources to include in the output. If not specified, all resources are included in the output. "resources": { # A list of FHIR resources. # List of resources to include in the output. If this list is empty or not specified, all resources are included in the output. diff --git a/docs/dyn/healthcare_v1beta1.projects.locations.html b/docs/dyn/healthcare_v1beta1.projects.locations.html index aabe493c337..2ad4b27677d 100644 --- a/docs/dyn/healthcare_v1beta1.projects.locations.html +++ b/docs/dyn/healthcare_v1beta1.projects.locations.html @@ -92,7 +92,7 @@

Instance Methods

Gets information about a location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -131,7 +131,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/googleapiclient/discovery_cache/documents/healthcare.v1.json b/googleapiclient/discovery_cache/documents/healthcare.v1.json
index 50b6f376353..45f09eff0ce 100644
--- a/googleapiclient/discovery_cache/documents/healthcare.v1.json
+++ b/googleapiclient/discovery_cache/documents/healthcare.v1.json
@@ -139,7 +139,7 @@
 ]
 },
 "list": {
-"description": "Lists information about the supported locations for this service.",
+"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.",
 "flatPath": "v1/projects/{projectsId}/locations",
 "httpMethod": "GET",
 "id": "healthcare.projects.locations.list",
@@ -3100,6 +3100,35 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"bulkDelete": {
+"description": "Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}:bulkDelete",
+"httpMethod": "POST",
+"id": "healthcare.projects.locations.datasets.fhirStores.bulkDelete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the FHIR store to bulk delete resources from, in the format of `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/fhirStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:bulkDelete",
+"request": {
+"$ref": "BulkDeleteResourcesRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-healthcare",
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "create": {
 "description": "Creates a new FHIR store within the parent dataset.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores",
@@ -5142,7 +5171,7 @@
 }
 }
 },
-"revision": "20251211",
+"revision": "20260128",
 "rootUrl": "https://healthcare.googleapis.com/",
 "schemas": {
 "AccessDeterminationLogConfig": {
@@ -5584,6 +5613,41 @@
 },
 "type": "object"
 },
+"BulkDeleteResourcesRequest": {
+"description": "Request to bulk delete FHIR resources.",
+"id": "BulkDeleteResourcesRequest",
+"properties": {
+"gcsDestination": {
+"$ref": "GoogleCloudHealthcareV1FhirGcsDestination",
+"description": "Optional. The Cloud Storage output destination. The Healthcare Service Agent account requires the `roles/storage.objectAdmin` role on the Cloud Storage location. The deleted resources outputs are organized by FHIR resource types. The server creates one or more objects per resource type. Each object contains newline delimited strings in the format {resourceType}/{resourceId}."
+},
+"type": {
+"description": "Optional. String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) will be deleted.",
+"type": "string"
+},
+"until": {
+"description": "Optional. If provided, only resources updated before or atthis time are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time must be specified to the second and include a time zone.",
+"type": "string"
+},
+"versionConfig": {
+"description": "Optional. Specifies which version of the resources to delete.",
+"enum": [
+"VERSION_CONFIG_UNSPECIFIED",
+"ALL",
+"CURRENT_ONLY",
+"HISTORY_ONLY"
+],
+"enumDescriptions": [
+"Unspecified version config. Defaults to ALL.",
+"Delete the current version and all history versions.",
+"Delete the current version only and create a historical version of the deleted resource.",
+"Delete all history versions only."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "BulkExportGcsDestination": {
 "description": "The configuration for exporting to Cloud Storage using the bulk export API.",
 "id": "BulkExportGcsDestination",
@@ -6087,7 +6151,7 @@
 "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified."
 },
 "destinationStore": {
-"description": "Required. The name of the DICOM store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination DICOM store must not exist. * The caller must have the necessary permissions to create the destination DICOM store.",
+"description": "Required. The name of the DICOM store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset and DICOM store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.dicomStores.dicomWebWrite permission to write to the destination DICOM store.",
 "type": "string"
 },
 "filterConfig": {
@@ -6110,7 +6174,7 @@
 "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified."
 },
 "destinationStore": {
-"description": "Required. The name of the FHIR store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination FHIR store must exist. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.",
+"description": "Required. The name of the FHIR store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.",
 "type": "string"
 },
 "gcsConfigUri": {
@@ -7073,7 +7137,7 @@
 "id": "GoogleCloudHealthcareV1DicomGcsDestination",
 "properties": {
 "mimeType": {
-"description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.",
+"description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 (DICOM Deflated Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with embedded JPEG Extended) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with embedded JPEG Lossless First-Order Prediction) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with embedded High-Throughput JPEG 2000 Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput JPEG 2000 with RPCL Options Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM with embedded RLE Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.",
 "type": "string"
 },
 "uriPrefix": {
diff --git a/googleapiclient/discovery_cache/documents/healthcare.v1beta1.json b/googleapiclient/discovery_cache/documents/healthcare.v1beta1.json
index 9822d400ef7..2fc87246f10 100644
--- a/googleapiclient/discovery_cache/documents/healthcare.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/healthcare.v1beta1.json
@@ -139,7 +139,7 @@
 ]
 },
 "list": {
-"description": "Lists information about the supported locations for this service.",
+"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.",
 "flatPath": "v1beta1/projects/{projectsId}/locations",
 "httpMethod": "GET",
 "id": "healthcare.projects.locations.list",
@@ -3285,6 +3285,35 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"bulkDelete": {
+"description": "Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}:bulkDelete",
+"httpMethod": "POST",
+"id": "healthcare.projects.locations.datasets.fhirStores.bulkDelete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the FHIR store to bulk delete resources from, in the format of `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/fhirStores/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}:bulkDelete",
+"request": {
+"$ref": "BulkDeleteResourcesRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-healthcare",
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "configureSearch": {
 "description": "Configure the search parameters for the FHIR store and reindex resources in the FHIR store according to the defined search parameters. The search parameters provided in this request will replace any previous search configuration. The target SearchParameter resources need to exist in the store before calling ConfigureSearch, otherwise an error will occur. This method returns an Operation that can be used to track the progress of the reindexing by calling GetOperation.",
 "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}:configureSearch",
@@ -5689,7 +5718,7 @@
 }
 }
 },
-"revision": "20251211",
+"revision": "20260128",
 "rootUrl": "https://healthcare.googleapis.com/",
 "schemas": {
 "AccessDeterminationLogConfig": {
@@ -6191,6 +6220,41 @@
 },
 "type": "object"
 },
+"BulkDeleteResourcesRequest": {
+"description": "Request to bulk delete FHIR resources.",
+"id": "BulkDeleteResourcesRequest",
+"properties": {
+"gcsDestination": {
+"$ref": "GoogleCloudHealthcareV1beta1FhirGcsDestination",
+"description": "Optional. The Cloud Storage output destination. The Healthcare Service Agent account requires the `roles/storage.objectAdmin` role on the Cloud Storage location. The deleted resources outputs are organized by FHIR resource types. The server creates one or more objects per resource type. Each object contains newline delimited strings in the format {resourceType}/{resourceId}."
+},
+"type": {
+"description": "Optional. String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) will be deleted.",
+"type": "string"
+},
+"until": {
+"description": "Optional. If provided, only resources updated before or atthis time are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time must be specified to the second and include a time zone.",
+"type": "string"
+},
+"versionConfig": {
+"description": "Optional. Specifies which version of the resources to delete.",
+"enum": [
+"VERSION_CONFIG_UNSPECIFIED",
+"ALL",
+"CURRENT_ONLY",
+"HISTORY_ONLY"
+],
+"enumDescriptions": [
+"Unspecified version config. Defaults to ALL.",
+"Delete the current version and all history versions.",
+"Delete the current version only and create a historical version of the deleted resource.",
+"Delete all history versions only."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "BulkExportGcsDestination": {
 "description": "The configuration for exporting to Cloud Storage using the bulk export API.",
 "id": "BulkExportGcsDestination",
@@ -6769,7 +6833,7 @@
 "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified."
 },
 "destinationStore": {
-"description": "Required. The name of the DICOM store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination DICOM store must not exist. * The caller must have the necessary permissions to create the destination DICOM store.",
+"description": "Required. The name of the DICOM store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset and DICOM store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.dicomStores.dicomWebWrite permission to write to the destination DICOM store.",
 "type": "string"
 },
 "filterConfig": {
@@ -6792,7 +6856,7 @@
 "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified."
 },
 "destinationStore": {
-"description": "Required. The name of the FHIR store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination FHIR store must exist. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.",
+"description": "Required. The name of the FHIR store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.",
 "type": "string"
 },
 "gcsConfigUri": {
@@ -7965,7 +8029,7 @@
 "id": "GoogleCloudHealthcareV1beta1DicomGcsDestination",
 "properties": {
 "mimeType": {
-"description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000)h - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.",
+"description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 (DICOM Deflated Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with embedded JPEG Extended) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with embedded JPEG Lossless First-Order Prediction) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with embedded High-Throughput JPEG 2000 Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput JPEG 2000 with RPCL Options Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM with embedded RLE Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -> .dcm - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.",
 "type": "string"
 },
 "uriPrefix": {

From af090e40eb13667bec8f9eab06642e723e474950 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 24 Feb 2026 07:27:57 +0000
Subject: [PATCH 17/29] feat(looker): update the api

#### looker:v1

The following keys were deleted:
- resources.projects.resources.locations.resources.instances.methods.undelete (Total Keys: 12)
- schemas.Instance.properties.catalogIntegrationEnabled.type (Total Keys: 1)
- schemas.Instance.properties.softDeleteReason (Total Keys: 2)
- schemas.Instance.properties.suspendedTime (Total Keys: 3)
- schemas.UndeleteInstanceRequest (Total Keys: 2)

The following keys were added:
- schemas.OAuthConfig.properties.sharedOauthClientEnabled.type (Total Keys: 1)
---
 docs/dyn/looker_v1.projects.locations.html    |  4 +-
 ...ooker_v1.projects.locations.instances.html | 60 ++--------------
 .../discovery_cache/documents/looker.v1.json  | 69 ++-----------------
 3 files changed, 12 insertions(+), 121 deletions(-)

diff --git a/docs/dyn/looker_v1.projects.locations.html b/docs/dyn/looker_v1.projects.locations.html
index 3fca5fa4e92..24ab143355d 100644
--- a/docs/dyn/looker_v1.projects.locations.html
+++ b/docs/dyn/looker_v1.projects.locations.html
@@ -92,7 +92,7 @@ 

Instance Methods

Gets information about a location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -131,7 +131,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/looker_v1.projects.locations.instances.html b/docs/dyn/looker_v1.projects.locations.instances.html
index 29140148ca1..3f07e3821dd 100644
--- a/docs/dyn/looker_v1.projects.locations.instances.html
+++ b/docs/dyn/looker_v1.projects.locations.instances.html
@@ -112,9 +112,6 @@ 

Instance Methods

restore(name, body=None, x__xgafv=None)

Restore Looker instance.

-

- undelete(name, body=None, x__xgafv=None)

-

Undeletes Looker instance.

Method Details

close() @@ -136,7 +133,6 @@

Method Details

"A String", ], }, - "catalogIntegrationEnabled": True or False, # Optional. Indicates whether catalog integration is enabled for the Looker instance. "classType": "A String", # Optional. Storage class of the instance. "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance. "controlledEgressConfig": { # Controlled egress configuration. # Optional. Controlled egress configuration. @@ -220,6 +216,7 @@

Method Details

"oauthConfig": { # Looker instance OAuth login settings. # Looker instance OAuth login settings. "clientId": "A String", # Input only. Client ID from an external OAuth application. This is an input-only field, and thus will not be set in any responses. "clientSecret": "A String", # Input only. Client secret from an external OAuth application. This is an input-only field, and thus will not be set in any responses. + "sharedOauthClientEnabled": True or False, # Optional. Whether to use the shared OAuth client. Instances specifying this field do not need to provide client_id and client_secret. }, "periodicExportConfig": { # Configuration for periodic export. # Optional. Configuration for periodic export. "gcsUri": "A String", # Required. Cloud Storage bucket URI for periodic export. Format: gs://{bucket_name} @@ -255,9 +252,7 @@

Method Details

"reservedRange": "A String", # Name of a reserved IP address range within the Instance.consumer_network, to be used for private services access connection. May or may not be specified in a create request. "satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. - "softDeleteReason": "A String", # Output only. The reason for the instance being in a soft-deleted state. "state": "A String", # Output only. The state of the instance. - "suspendedTime": "A String", # Output only. The time when the Looker instance was suspended (soft deleted). "updateTime": "A String", # Output only. The time when the Looker instance was last updated. "userMetadata": { # Metadata about users for a Looker instance. # Optional. User metadata. "additionalDeveloperUserCount": 42, # Optional. The number of additional developer users the instance owner has purchased. @@ -397,7 +392,6 @@

Method Details

"A String", ], }, - "catalogIntegrationEnabled": True or False, # Optional. Indicates whether catalog integration is enabled for the Looker instance. "classType": "A String", # Optional. Storage class of the instance. "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance. "controlledEgressConfig": { # Controlled egress configuration. # Optional. Controlled egress configuration. @@ -481,6 +475,7 @@

Method Details

"oauthConfig": { # Looker instance OAuth login settings. # Looker instance OAuth login settings. "clientId": "A String", # Input only. Client ID from an external OAuth application. This is an input-only field, and thus will not be set in any responses. "clientSecret": "A String", # Input only. Client secret from an external OAuth application. This is an input-only field, and thus will not be set in any responses. + "sharedOauthClientEnabled": True or False, # Optional. Whether to use the shared OAuth client. Instances specifying this field do not need to provide client_id and client_secret. }, "periodicExportConfig": { # Configuration for periodic export. # Optional. Configuration for periodic export. "gcsUri": "A String", # Required. Cloud Storage bucket URI for periodic export. Format: gs://{bucket_name} @@ -516,9 +511,7 @@

Method Details

"reservedRange": "A String", # Name of a reserved IP address range within the Instance.consumer_network, to be used for private services access connection. May or may not be specified in a create request. "satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. - "softDeleteReason": "A String", # Output only. The reason for the instance being in a soft-deleted state. "state": "A String", # Output only. The state of the instance. - "suspendedTime": "A String", # Output only. The time when the Looker instance was suspended (soft deleted). "updateTime": "A String", # Output only. The time when the Looker instance was last updated. "userMetadata": { # Metadata about users for a Looker instance. # Optional. User metadata. "additionalDeveloperUserCount": 42, # Optional. The number of additional developer users the instance owner has purchased. @@ -594,7 +587,6 @@

Method Details

"A String", ], }, - "catalogIntegrationEnabled": True or False, # Optional. Indicates whether catalog integration is enabled for the Looker instance. "classType": "A String", # Optional. Storage class of the instance. "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance. "controlledEgressConfig": { # Controlled egress configuration. # Optional. Controlled egress configuration. @@ -678,6 +670,7 @@

Method Details

"oauthConfig": { # Looker instance OAuth login settings. # Looker instance OAuth login settings. "clientId": "A String", # Input only. Client ID from an external OAuth application. This is an input-only field, and thus will not be set in any responses. "clientSecret": "A String", # Input only. Client secret from an external OAuth application. This is an input-only field, and thus will not be set in any responses. + "sharedOauthClientEnabled": True or False, # Optional. Whether to use the shared OAuth client. Instances specifying this field do not need to provide client_id and client_secret. }, "periodicExportConfig": { # Configuration for periodic export. # Optional. Configuration for periodic export. "gcsUri": "A String", # Required. Cloud Storage bucket URI for periodic export. Format: gs://{bucket_name} @@ -713,9 +706,7 @@

Method Details

"reservedRange": "A String", # Name of a reserved IP address range within the Instance.consumer_network, to be used for private services access connection. May or may not be specified in a create request. "satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. - "softDeleteReason": "A String", # Output only. The reason for the instance being in a soft-deleted state. "state": "A String", # Output only. The state of the instance. - "suspendedTime": "A String", # Output only. The time when the Looker instance was suspended (soft deleted). "updateTime": "A String", # Output only. The time when the Looker instance was last updated. "userMetadata": { # Metadata about users for a Looker instance. # Optional. User metadata. "additionalDeveloperUserCount": 42, # Optional. The number of additional developer users the instance owner has purchased. @@ -760,7 +751,6 @@

Method Details

"A String", ], }, - "catalogIntegrationEnabled": True or False, # Optional. Indicates whether catalog integration is enabled for the Looker instance. "classType": "A String", # Optional. Storage class of the instance. "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance. "controlledEgressConfig": { # Controlled egress configuration. # Optional. Controlled egress configuration. @@ -844,6 +834,7 @@

Method Details

"oauthConfig": { # Looker instance OAuth login settings. # Looker instance OAuth login settings. "clientId": "A String", # Input only. Client ID from an external OAuth application. This is an input-only field, and thus will not be set in any responses. "clientSecret": "A String", # Input only. Client secret from an external OAuth application. This is an input-only field, and thus will not be set in any responses. + "sharedOauthClientEnabled": True or False, # Optional. Whether to use the shared OAuth client. Instances specifying this field do not need to provide client_id and client_secret. }, "periodicExportConfig": { # Configuration for periodic export. # Optional. Configuration for periodic export. "gcsUri": "A String", # Required. Cloud Storage bucket URI for periodic export. Format: gs://{bucket_name} @@ -879,9 +870,7 @@

Method Details

"reservedRange": "A String", # Name of a reserved IP address range within the Instance.consumer_network, to be used for private services access connection. May or may not be specified in a create request. "satisfiesPzi": True or False, # Output only. Reserved for future use. "satisfiesPzs": True or False, # Output only. Reserved for future use. - "softDeleteReason": "A String", # Output only. The reason for the instance being in a soft-deleted state. "state": "A String", # Output only. The state of the instance. - "suspendedTime": "A String", # Output only. The time when the Looker instance was suspended (soft deleted). "updateTime": "A String", # Output only. The time when the Looker instance was last updated. "userMetadata": { # Metadata about users for a Looker instance. # Optional. User metadata. "additionalDeveloperUserCount": 42, # Optional. The number of additional developer users the instance owner has purchased. @@ -1003,45 +992,4 @@

Method Details

}
-
- undelete(name, body=None, x__xgafv=None) -
Undeletes Looker instance.
-
-Args:
-  name: string, Required. Format: projects/{project}/locations/{location}/instances/{instance} (required)
-  body: object, The request body.
-    The object takes the form of:
-
-{ # Request options for undeleting an instance.
-}
-
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # This resource represents a long-running operation that is the result of a network API call.
-  "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
-  "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
-    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
-    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
-      {
-        "a_key": "", # Properties of the object. Contains field @type with type URL.
-      },
-    ],
-    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
-  },
-  "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
-    "a_key": "", # Properties of the object. Contains field @type with type URL.
-  },
-  "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
-  "response": { # 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`.
-    "a_key": "", # Properties of the object. Contains field @type with type URL.
-  },
-}
-
- \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/looker.v1.json b/googleapiclient/discovery_cache/documents/looker.v1.json index c0800e8f3c5..c93801e77ed 100644 --- a/googleapiclient/discovery_cache/documents/looker.v1.json +++ b/googleapiclient/discovery_cache/documents/looker.v1.json @@ -135,7 +135,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "looker.projects.locations.list", @@ -454,34 +454,6 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] -}, -"undelete": { -"description": "Undeletes Looker instance.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:undelete", -"httpMethod": "POST", -"id": "looker.projects.locations.instances.undelete", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+name}:undelete", -"request": { -"$ref": "UndeleteInstanceRequest" -}, -"response": { -"$ref": "Operation" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] } }, "resources": { @@ -743,7 +715,7 @@ } } }, -"revision": "20260119", +"revision": "20260216", "rootUrl": "https://looker.googleapis.com/", "schemas": { "AdminSettings": { @@ -1011,10 +983,6 @@ "$ref": "AdminSettings", "description": "Looker Instance Admin settings." }, -"catalogIntegrationEnabled": { -"description": "Optional. Indicates whether catalog integration is enabled for the Looker instance.", -"type": "boolean" -}, "classType": { "description": "Optional. Storage class of the instance.", "enum": [ @@ -1185,23 +1153,6 @@ "readOnly": true, "type": "boolean" }, -"softDeleteReason": { -"description": "Output only. The reason for the instance being in a soft-deleted state.", -"enum": [ -"SOFT_DELETE_REASON_UNSPECIFIED", -"BILLING_ACCOUNT_ISSUE", -"TRIAL_EXPIRED", -"CUSTOMER_REQUEST" -], -"enumDescriptions": [ -"Soft delete reason is unspecified. This is the default value.", -"Instance is soft deleted due to billing account issues.", -"Instance is soft deleted due to trial expiration.", -"Instance is soft deleted by the customer." -], -"readOnly": true, -"type": "string" -}, "state": { "description": "Output only. The state of the instance.", "enum": [ @@ -1229,12 +1180,6 @@ "readOnly": true, "type": "string" }, -"suspendedTime": { -"description": "Output only. The time when the Looker instance was suspended (soft deleted).", -"format": "google-datetime", -"readOnly": true, -"type": "string" -}, "updateTime": { "description": "Output only. The time when the Looker instance was last updated.", "format": "google-datetime", @@ -1485,6 +1430,10 @@ "clientSecret": { "description": "Input only. Client secret from an external OAuth application. This is an input-only field, and thus will not be set in any responses.", "type": "string" +}, +"sharedOauthClientEnabled": { +"description": "Optional. Whether to use the shared OAuth client. Instances specifying this field do not need to provide client_id and client_secret.", +"type": "boolean" } }, "type": "object" @@ -1725,12 +1674,6 @@ }, "type": "object" }, -"UndeleteInstanceRequest": { -"description": "Request options for undeleting an instance.", -"id": "UndeleteInstanceRequest", -"properties": {}, -"type": "object" -}, "UserMetadata": { "description": "Metadata about users for a Looker instance.", "id": "UserMetadata", From 5bc65f2e9d7781f804db951bbdf91d7e509eec74 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 18/29] feat(monitoring): update the api #### monitoring:v1 The following keys were added: - schemas.CoordinatedWidget (Total Keys: 4) - schemas.Widget.properties.coordinatedWidget.$ref (Total Keys: 1) --- .../monitoring_v1.projects.dashboards.html | 96 +++++++++++++++++++ .../documents/monitoring.v1.json | 21 +++- 2 files changed, 116 insertions(+), 1 deletion(-) diff --git a/docs/dyn/monitoring_v1.projects.dashboards.html b/docs/dyn/monitoring_v1.projects.dashboards.html index b2e2e2171ad..cf132afaaf5 100644 --- a/docs/dyn/monitoring_v1.projects.dashboards.html +++ b/docs/dyn/monitoring_v1.projects.dashboards.html @@ -141,6 +141,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -1010,6 +1014,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -1775,6 +1783,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -2542,6 +2554,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -3334,6 +3350,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -4203,6 +4223,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -4968,6 +4992,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -5735,6 +5763,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -6551,6 +6583,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -7420,6 +7456,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -8185,6 +8225,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -8952,6 +8996,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -9754,6 +9802,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -10623,6 +10675,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -11388,6 +11444,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -12155,6 +12215,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -12965,6 +13029,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -13834,6 +13902,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -14599,6 +14671,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -15366,6 +15442,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -16158,6 +16238,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -17027,6 +17111,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -17792,6 +17880,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", @@ -18559,6 +18651,10 @@

Method Details

"collapsibleGroup": { # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. # A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets. "collapsed": True or False, # The collapsed state of the widget on first page load. }, + "coordinatedWidget": { # A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart. # A widget that contains two widget visualizations that are coordinated in display. + "primary": # Object with schema name: Widget # Required. The primary visualization. Must be set. Must contain a data source. + "secondary": # Object with schema name: Widget # Required. The secondary visualization. Must be set. Must contain a data source. + }, "errorReportingPanel": { # A widget that displays a list of error groups. # A widget that displays a list of error groups. "projectNames": [ # The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234. "A String", diff --git a/googleapiclient/discovery_cache/documents/monitoring.v1.json b/googleapiclient/discovery_cache/documents/monitoring.v1.json index 8032e42fe61..3ee8a6a7401 100644 --- a/googleapiclient/discovery_cache/documents/monitoring.v1.json +++ b/googleapiclient/discovery_cache/documents/monitoring.v1.json @@ -753,7 +753,7 @@ } } }, -"revision": "20260108", +"revision": "20260212", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -1087,6 +1087,21 @@ }, "type": "object" }, +"CoordinatedWidget": { +"description": "A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart.", +"id": "CoordinatedWidget", +"properties": { +"primary": { +"$ref": "Widget", +"description": "Required. The primary visualization. Must be set. Must contain a data source." +}, +"secondary": { +"$ref": "Widget", +"description": "Required. The secondary visualization. Must be set. Must contain a data source." +} +}, +"type": "object" +}, "Dashboard": { "description": "A Google Stackdriver dashboard. Dashboards define the content and layout of pages in the Stackdriver web application.", "id": "Dashboard", @@ -3006,6 +3021,10 @@ "$ref": "CollapsibleGroup", "description": "A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets." }, +"coordinatedWidget": { +"$ref": "CoordinatedWidget", +"description": "A widget that contains two widget visualizations that are coordinated in display." +}, "errorReportingPanel": { "$ref": "ErrorReportingPanel", "description": "A widget that displays a list of error groups." From 3bad9b7d3d2a00ea5b748c2d07b8daec7e3c844a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 19/29] feat(netapp): update the api #### netapp:v1 The following keys were added: - schemas.CloneDetails (Total Keys: 9) - schemas.Volume.properties.cloneDetails (Total Keys: 2) #### netapp:v1beta1 The following keys were added: - resources.projects.resources.locations.resources.storagePools.resources.ontap.methods.executeOntapDelete (Total Keys: 11) - resources.projects.resources.locations.resources.storagePools.resources.ontap.methods.executeOntapGet (Total Keys: 11) - resources.projects.resources.locations.resources.storagePools.resources.ontap.methods.executeOntapPatch (Total Keys: 12) - resources.projects.resources.locations.resources.storagePools.resources.ontap.methods.executeOntapPost (Total Keys: 12) - schemas.CloneDetails (Total Keys: 9) - schemas.ExecuteOntapDeleteResponse (Total Keys: 4) - schemas.ExecuteOntapGetResponse (Total Keys: 4) - schemas.ExecuteOntapPatchRequest (Total Keys: 4) - schemas.ExecuteOntapPatchResponse (Total Keys: 4) - schemas.ExecuteOntapPostRequest (Total Keys: 4) - schemas.ExecuteOntapPostResponse (Total Keys: 4) - schemas.LargeCapacityConfig (Total Keys: 4) - schemas.StoragePool.properties.mode.type (Total Keys: 1) - schemas.StoragePool.properties.scaleTier.type (Total Keys: 1) - schemas.Volume.properties.cloneDetails (Total Keys: 2) - schemas.Volume.properties.largeCapacityConfig.$ref (Total Keys: 1) --- .../netapp_v1.projects.locations.volumes.html | 20 ++ ...beta1.projects.locations.storagePools.html | 13 + ...projects.locations.storagePools.ontap.html | 200 +++++++++++++ ...pp_v1beta1.projects.locations.volumes.html | 32 ++ .../discovery_cache/documents/netapp.v1.json | 30 +- .../documents/netapp.v1beta1.json | 276 +++++++++++++++++- 6 files changed, 569 insertions(+), 2 deletions(-) create mode 100644 docs/dyn/netapp_v1beta1.projects.locations.storagePools.ontap.html diff --git a/docs/dyn/netapp_v1.projects.locations.volumes.html b/docs/dyn/netapp_v1.projects.locations.volumes.html index e2cbb176f19..808c955408c 100644 --- a/docs/dyn/netapp_v1.projects.locations.volumes.html +++ b/docs/dyn/netapp_v1.projects.locations.volumes.html @@ -184,6 +184,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume @@ -480,6 +485,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume @@ -674,6 +684,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume @@ -869,6 +884,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume diff --git a/docs/dyn/netapp_v1beta1.projects.locations.storagePools.html b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.html index b173e4421d0..162f2a0826b 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.storagePools.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.html @@ -74,6 +74,11 @@

NetApp API . projects . locations . storagePools

Instance Methods

+

+ ontap() +

+

Returns the ontap Resource.

+

close()

Close httplib2 connections.

@@ -135,6 +140,7 @@

Method Details

"a_key": "A String", }, "ldapEnabled": True or False, # Optional. Flag indicating if the pool is NFS LDAP enabled or not. + "mode": "A String", # Optional. Mode of the storage pool. This field is used to control whether the user can perform the ONTAP operations on the storage pool using the GCNV ONTAP Mode APIs. If not specified during creation, it defaults to `DEFAULT`. "name": "A String", # Identifier. Name of the storage pool "network": "A String", # Required. VPC Network name. Format: projects/{project}/global/networks/{network} "psaRange": "A String", # Optional. This field is not implemented. The values provided in this field are ignored. @@ -142,6 +148,7 @@

Method Details

"replicaZone": "A String", # Optional. Specifies the replica zone for regional storagePool. "satisfiesPzi": True or False, # Output only. Reserved for future use "satisfiesPzs": True or False, # Output only. Reserved for future use + "scaleTier": "A String", # Optional. The effective scale tier of the storage pool. If `scale_tier` is not specified during creation, this defaults to `SCALE_TIER_STANDARD`. "serviceLevel": "A String", # Required. Service level of the storage pool "state": "A String", # Output only. State of the storage pool "stateDetails": "A String", # Output only. State details of the storage pool @@ -251,6 +258,7 @@

Method Details

"a_key": "A String", }, "ldapEnabled": True or False, # Optional. Flag indicating if the pool is NFS LDAP enabled or not. + "mode": "A String", # Optional. Mode of the storage pool. This field is used to control whether the user can perform the ONTAP operations on the storage pool using the GCNV ONTAP Mode APIs. If not specified during creation, it defaults to `DEFAULT`. "name": "A String", # Identifier. Name of the storage pool "network": "A String", # Required. VPC Network name. Format: projects/{project}/global/networks/{network} "psaRange": "A String", # Optional. This field is not implemented. The values provided in this field are ignored. @@ -258,6 +266,7 @@

Method Details

"replicaZone": "A String", # Optional. Specifies the replica zone for regional storagePool. "satisfiesPzi": True or False, # Output only. Reserved for future use "satisfiesPzs": True or False, # Output only. Reserved for future use + "scaleTier": "A String", # Optional. The effective scale tier of the storage pool. If `scale_tier` is not specified during creation, this defaults to `SCALE_TIER_STANDARD`. "serviceLevel": "A String", # Required. Service level of the storage pool "state": "A String", # Output only. State of the storage pool "stateDetails": "A String", # Output only. State details of the storage pool @@ -310,6 +319,7 @@

Method Details

"a_key": "A String", }, "ldapEnabled": True or False, # Optional. Flag indicating if the pool is NFS LDAP enabled or not. + "mode": "A String", # Optional. Mode of the storage pool. This field is used to control whether the user can perform the ONTAP operations on the storage pool using the GCNV ONTAP Mode APIs. If not specified during creation, it defaults to `DEFAULT`. "name": "A String", # Identifier. Name of the storage pool "network": "A String", # Required. VPC Network name. Format: projects/{project}/global/networks/{network} "psaRange": "A String", # Optional. This field is not implemented. The values provided in this field are ignored. @@ -317,6 +327,7 @@

Method Details

"replicaZone": "A String", # Optional. Specifies the replica zone for regional storagePool. "satisfiesPzi": True or False, # Output only. Reserved for future use "satisfiesPzs": True or False, # Output only. Reserved for future use + "scaleTier": "A String", # Optional. The effective scale tier of the storage pool. If `scale_tier` is not specified during creation, this defaults to `SCALE_TIER_STANDARD`. "serviceLevel": "A String", # Required. Service level of the storage pool "state": "A String", # Output only. State of the storage pool "stateDetails": "A String", # Output only. State details of the storage pool @@ -376,6 +387,7 @@

Method Details

"a_key": "A String", }, "ldapEnabled": True or False, # Optional. Flag indicating if the pool is NFS LDAP enabled or not. + "mode": "A String", # Optional. Mode of the storage pool. This field is used to control whether the user can perform the ONTAP operations on the storage pool using the GCNV ONTAP Mode APIs. If not specified during creation, it defaults to `DEFAULT`. "name": "A String", # Identifier. Name of the storage pool "network": "A String", # Required. VPC Network name. Format: projects/{project}/global/networks/{network} "psaRange": "A String", # Optional. This field is not implemented. The values provided in this field are ignored. @@ -383,6 +395,7 @@

Method Details

"replicaZone": "A String", # Optional. Specifies the replica zone for regional storagePool. "satisfiesPzi": True or False, # Output only. Reserved for future use "satisfiesPzs": True or False, # Output only. Reserved for future use + "scaleTier": "A String", # Optional. The effective scale tier of the storage pool. If `scale_tier` is not specified during creation, this defaults to `SCALE_TIER_STANDARD`. "serviceLevel": "A String", # Required. Service level of the storage pool "state": "A String", # Output only. State of the storage pool "stateDetails": "A String", # Output only. State details of the storage pool diff --git a/docs/dyn/netapp_v1beta1.projects.locations.storagePools.ontap.html b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.ontap.html new file mode 100644 index 00000000000..9a63cd4844d --- /dev/null +++ b/docs/dyn/netapp_v1beta1.projects.locations.storagePools.ontap.html @@ -0,0 +1,200 @@ + + + +

NetApp API . projects . locations . storagePools . ontap

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ executeOntapDelete(ontapPath, x__xgafv=None)

+

`ExecuteOntapDelete` dispatches the ONTAP `DELETE` request to the `StoragePool` cluster.

+

+ executeOntapGet(ontapPath, x__xgafv=None)

+

`ExecuteOntapGet` dispatches the ONTAP `GET` request to the `StoragePool` cluster.

+

+ executeOntapPatch(ontapPath, body=None, x__xgafv=None)

+

`ExecuteOntapPatch` dispatches the ONTAP `PATCH` request to the `StoragePool` cluster.

+

+ executeOntapPost(ontapPath, body=None, x__xgafv=None)

+

`ExecuteOntapPost` dispatches the ONTAP `POST` request to the `StoragePool` cluster.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ executeOntapDelete(ontapPath, x__xgafv=None) +
`ExecuteOntapDelete` dispatches the ONTAP `DELETE` request to the `StoragePool` cluster.
+
+Args:
+  ontapPath: string, Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for `ExecuteOntapDelete` API.
+  "body": { # The raw `JSON` body of the response.
+    "a_key": "", # Properties of the object.
+  },
+}
+
+ +
+ executeOntapGet(ontapPath, x__xgafv=None) +
`ExecuteOntapGet` dispatches the ONTAP `GET` request to the `StoragePool` cluster.
+
+Args:
+  ontapPath: string, Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for `ExecuteOntapGet` API.
+  "body": { # The raw `JSON` body of the response.
+    "a_key": "", # Properties of the object.
+  },
+}
+
+ +
+ executeOntapPatch(ontapPath, body=None, x__xgafv=None) +
`ExecuteOntapPatch` dispatches the ONTAP `PATCH` request to the `StoragePool` cluster.
+
+Args:
+  ontapPath: string, Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for `ExecuteOntapPatch` API.
+  "body": { # Required. The raw `JSON` body of the request. The body should be in the format of the ONTAP resource. For example: ``` { "body": { "field1": "value1", "field2": "value2", } } ```
+    "a_key": "", # Properties of the object.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for `ExecuteOntapPatch` API.
+  "body": { # The raw `JSON` body of the response.
+    "a_key": "", # Properties of the object.
+  },
+}
+
+ +
+ executeOntapPost(ontapPath, body=None, x__xgafv=None) +
`ExecuteOntapPost` dispatches the ONTAP `POST` request to the `StoragePool` cluster.
+
+Args:
+  ontapPath: string, Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for `ExecuteOntapPost` API.
+  "body": { # Required. The raw `JSON` body of the request. The body should be in the format of the ONTAP resource. For example: ``` { "body": { "field1": "value1", "field2": "value2", } } ```
+    "a_key": "", # Properties of the object.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for `ExecuteOntapPost` API.
+  "body": { # The raw `JSON` body of the response.
+    "a_key": "", # Properties of the object.
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/netapp_v1beta1.projects.locations.volumes.html b/docs/dyn/netapp_v1beta1.projects.locations.volumes.html index b6ec6c312fe..e4e63790551 100644 --- a/docs/dyn/netapp_v1beta1.projects.locations.volumes.html +++ b/docs/dyn/netapp_v1beta1.projects.locations.volumes.html @@ -184,6 +184,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume @@ -232,6 +237,9 @@

Method Details

"a_key": "A String", }, "largeCapacity": True or False, # Optional. Flag indicating if the volume will be a large capacity volume or a regular volume. + "largeCapacityConfig": { # Configuration for a Large Capacity Volume. A Large Capacity Volume supports sizes ranging from 12 TiB to 20 PiB, it is composed of multiple internal constituents, and must be created in a large capacity pool. # Optional. Large capacity config for the volume. + "constituentCount": 42, # Optional. The number of internal constituents (e.g., FlexVols) for this large volume. The minimum number of constituents is 2. + }, "ldapEnabled": True or False, # Output only. Flag indicating if the volume is NFS LDAP enabled or not. "mountOptions": [ # Output only. Mount options of this volume { # View only mount options for a volume. @@ -480,6 +488,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume @@ -528,6 +541,9 @@

Method Details

"a_key": "A String", }, "largeCapacity": True or False, # Optional. Flag indicating if the volume will be a large capacity volume or a regular volume. + "largeCapacityConfig": { # Configuration for a Large Capacity Volume. A Large Capacity Volume supports sizes ranging from 12 TiB to 20 PiB, it is composed of multiple internal constituents, and must be created in a large capacity pool. # Optional. Large capacity config for the volume. + "constituentCount": 42, # Optional. The number of internal constituents (e.g., FlexVols) for this large volume. The minimum number of constituents is 2. + }, "ldapEnabled": True or False, # Output only. Flag indicating if the volume is NFS LDAP enabled or not. "mountOptions": [ # Output only. Mount options of this volume { # View only mount options for a volume. @@ -674,6 +690,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume @@ -722,6 +743,9 @@

Method Details

"a_key": "A String", }, "largeCapacity": True or False, # Optional. Flag indicating if the volume will be a large capacity volume or a regular volume. + "largeCapacityConfig": { # Configuration for a Large Capacity Volume. A Large Capacity Volume supports sizes ranging from 12 TiB to 20 PiB, it is composed of multiple internal constituents, and must be created in a large capacity pool. # Optional. Large capacity config for the volume. + "constituentCount": 42, # Optional. The number of internal constituents (e.g., FlexVols) for this large volume. The minimum number of constituents is 2. + }, "ldapEnabled": True or False, # Output only. Flag indicating if the volume is NFS LDAP enabled or not. "mountOptions": [ # Output only. Mount options of this volume { # View only mount options for a volume. @@ -869,6 +893,11 @@

Method Details

"stateDetails": "A String", # Output only. Detailed description of the current cache state. }, "capacityGib": "A String", # Required. Capacity in GIB of the volume + "cloneDetails": { # Details about a clone volume. # Output only. If this volume is a clone, this field contains details about the clone. + "sharedSpaceGib": "A String", # Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot. + "sourceSnapshot": "A String", # Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + "sourceVolume": "A String", # Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume} + }, "coldTierSizeGib": "A String", # Output only. Size of the volume cold tier data rounded down to the nearest GiB. "createTime": "A String", # Output only. Create time of the volume "description": "A String", # Optional. Description of the volume @@ -917,6 +946,9 @@

Method Details

"a_key": "A String", }, "largeCapacity": True or False, # Optional. Flag indicating if the volume will be a large capacity volume or a regular volume. + "largeCapacityConfig": { # Configuration for a Large Capacity Volume. A Large Capacity Volume supports sizes ranging from 12 TiB to 20 PiB, it is composed of multiple internal constituents, and must be created in a large capacity pool. # Optional. Large capacity config for the volume. + "constituentCount": 42, # Optional. The number of internal constituents (e.g., FlexVols) for this large volume. The minimum number of constituents is 2. + }, "ldapEnabled": True or False, # Output only. Flag indicating if the volume is NFS LDAP enabled or not. "mountOptions": [ # Output only. Mount options of this volume { # View only mount options for a volume. diff --git a/googleapiclient/discovery_cache/documents/netapp.v1.json b/googleapiclient/discovery_cache/documents/netapp.v1.json index 65e74edbce4..52580acd235 100644 --- a/googleapiclient/discovery_cache/documents/netapp.v1.json +++ b/googleapiclient/discovery_cache/documents/netapp.v1.json @@ -2715,7 +2715,7 @@ } } }, -"revision": "20260125", +"revision": "20260218", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -3391,6 +3391,29 @@ "properties": {}, "type": "object" }, +"CloneDetails": { +"description": "Details about a clone volume.", +"id": "CloneDetails", +"properties": { +"sharedSpaceGib": { +"description": "Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"sourceSnapshot": { +"description": "Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot}", +"readOnly": true, +"type": "string" +}, +"sourceVolume": { +"description": "Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume}", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "DailySchedule": { "description": "Make a snapshot every day e.g. at 04:00, 05:20, 23:50", "id": "DailySchedule", @@ -5322,6 +5345,11 @@ true "format": "int64", "type": "string" }, +"cloneDetails": { +"$ref": "CloneDetails", +"description": "Output only. If this volume is a clone, this field contains details about the clone.", +"readOnly": true +}, "coldTierSizeGib": { "description": "Output only. Size of the volume cold tier data rounded down to the nearest GiB.", "format": "int64", diff --git a/googleapiclient/discovery_cache/documents/netapp.v1beta1.json b/googleapiclient/discovery_cache/documents/netapp.v1beta1.json index 2299376e34d..e197dd09a03 100644 --- a/googleapiclient/discovery_cache/documents/netapp.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/netapp.v1beta1.json @@ -1809,6 +1809,118 @@ "https://www.googleapis.com/auth/cloud-platform" ] } +}, +"resources": { +"ontap": { +"methods": { +"executeOntapDelete": { +"description": "`ExecuteOntapDelete` dispatches the ONTAP `DELETE` request to the `StoragePool` cluster.", +"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", +"httpMethod": "DELETE", +"id": "netapp.projects.locations.storagePools.ontap.executeOntapDelete", +"parameterOrder": [ +"ontapPath" +], +"parameters": { +"ontapPath": { +"description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+ontapPath}", +"response": { +"$ref": "ExecuteOntapDeleteResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"executeOntapGet": { +"description": "`ExecuteOntapGet` dispatches the ONTAP `GET` request to the `StoragePool` cluster.", +"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", +"httpMethod": "GET", +"id": "netapp.projects.locations.storagePools.ontap.executeOntapGet", +"parameterOrder": [ +"ontapPath" +], +"parameters": { +"ontapPath": { +"description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+ontapPath}", +"response": { +"$ref": "ExecuteOntapGetResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"executeOntapPatch": { +"description": "`ExecuteOntapPatch` dispatches the ONTAP `PATCH` request to the `StoragePool` cluster.", +"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", +"httpMethod": "PATCH", +"id": "netapp.projects.locations.storagePools.ontap.executeOntapPatch", +"parameterOrder": [ +"ontapPath" +], +"parameters": { +"ontapPath": { +"description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+ontapPath}", +"request": { +"$ref": "ExecuteOntapPatchRequest" +}, +"response": { +"$ref": "ExecuteOntapPatchResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"executeOntapPost": { +"description": "`ExecuteOntapPost` dispatches the ONTAP `POST` request to the `StoragePool` cluster.", +"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", +"httpMethod": "POST", +"id": "netapp.projects.locations.storagePools.ontap.executeOntapPost", +"parameterOrder": [ +"ontapPath" +], +"parameters": { +"ontapPath": { +"description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+ontapPath}", +"request": { +"$ref": "ExecuteOntapPostRequest" +}, +"response": { +"$ref": "ExecuteOntapPostResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +} } }, "volumes": { @@ -2715,7 +2827,7 @@ } } }, -"revision": "20260125", +"revision": "20260218", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -3391,6 +3503,29 @@ "properties": {}, "type": "object" }, +"CloneDetails": { +"description": "Details about a clone volume.", +"id": "CloneDetails", +"properties": { +"sharedSpaceGib": { +"description": "Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"sourceSnapshot": { +"description": "Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot}", +"readOnly": true, +"type": "string" +}, +"sourceVolume": { +"description": "Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume}", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "DailySchedule": { "description": "Make a snapshot every day e.g. at 04:00, 05:20, 23:50", "id": "DailySchedule", @@ -3498,6 +3633,96 @@ }, "type": "object" }, +"ExecuteOntapDeleteResponse": { +"description": "Response message for `ExecuteOntapDelete` API.", +"id": "ExecuteOntapDeleteResponse", +"properties": { +"body": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "The raw `JSON` body of the response.", +"type": "object" +} +}, +"type": "object" +}, +"ExecuteOntapGetResponse": { +"description": "Response message for `ExecuteOntapGet` API.", +"id": "ExecuteOntapGetResponse", +"properties": { +"body": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "The raw `JSON` body of the response.", +"type": "object" +} +}, +"type": "object" +}, +"ExecuteOntapPatchRequest": { +"description": "Request message for `ExecuteOntapPatch` API.", +"id": "ExecuteOntapPatchRequest", +"properties": { +"body": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Required. The raw `JSON` body of the request. The body should be in the format of the ONTAP resource. For example: ``` { \"body\": { \"field1\": \"value1\", \"field2\": \"value2\", } } ```", +"type": "object" +} +}, +"type": "object" +}, +"ExecuteOntapPatchResponse": { +"description": "Response message for `ExecuteOntapPatch` API.", +"id": "ExecuteOntapPatchResponse", +"properties": { +"body": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "The raw `JSON` body of the response.", +"type": "object" +} +}, +"type": "object" +}, +"ExecuteOntapPostRequest": { +"description": "Request message for `ExecuteOntapPost` API.", +"id": "ExecuteOntapPostRequest", +"properties": { +"body": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Required. The raw `JSON` body of the request. The body should be in the format of the ONTAP resource. For example: ``` { \"body\": { \"field1\": \"value1\", \"field2\": \"value2\", } } ```", +"type": "object" +} +}, +"type": "object" +}, +"ExecuteOntapPostResponse": { +"description": "Response message for `ExecuteOntapPost` API.", +"id": "ExecuteOntapPostResponse", +"properties": { +"body": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "The raw `JSON` body of the response.", +"type": "object" +} +}, +"type": "object" +}, "ExportPolicy": { "description": "Defines the export policy for the volume.", "id": "ExportPolicy", @@ -3826,6 +4051,18 @@ }, "type": "object" }, +"LargeCapacityConfig": { +"description": "Configuration for a Large Capacity Volume. A Large Capacity Volume supports sizes ranging from 12 TiB to 20 PiB, it is composed of multiple internal constituents, and must be created in a large capacity pool.", +"id": "LargeCapacityConfig", +"properties": { +"constituentCount": { +"description": "Optional. The number of internal constituents (e.g., FlexVols) for this large volume. The minimum number of constituents is 2.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, "ListActiveDirectoriesResponse": { "description": "ListActiveDirectoriesResponse contains all the active directories requested.", "id": "ListActiveDirectoriesResponse", @@ -5004,6 +5241,20 @@ "description": "Optional. Flag indicating if the pool is NFS LDAP enabled or not.", "type": "boolean" }, +"mode": { +"description": "Optional. Mode of the storage pool. This field is used to control whether the user can perform the ONTAP operations on the storage pool using the GCNV ONTAP Mode APIs. If not specified during creation, it defaults to `DEFAULT`.", +"enum": [ +"MODE_UNSPECIFIED", +"DEFAULT", +"ONTAP" +], +"enumDescriptions": [ +"The `StoragePool` `Mode` is not specified.", +"The `StoragePool` and its resources are managed by the GCNV APIs.", +"The `StoragePool` and its resources are managed by the GCNV ONTAP Mode APIs." +], +"type": "string" +}, "name": { "description": "Identifier. Name of the storage pool", "type": "string" @@ -5044,6 +5295,20 @@ "readOnly": true, "type": "boolean" }, +"scaleTier": { +"description": "Optional. The effective scale tier of the storage pool. If `scale_tier` is not specified during creation, this defaults to `SCALE_TIER_STANDARD`.", +"enum": [ +"SCALE_TIER_UNSPECIFIED", +"SCALE_TIER_STANDARD", +"SCALE_TIER_ENTERPRISE" +], +"enumDescriptions": [ +"The default value. This value is unused.", +"The standard capacity and performance tier. Suitable for general purpose workloads.", +"A higher capacity and performance tier. Suitable for more demanding workloads." +], +"type": "string" +}, "serviceLevel": { "description": "Required. Service level of the storage pool", "enum": [ @@ -5322,6 +5587,11 @@ true "format": "int64", "type": "string" }, +"cloneDetails": { +"$ref": "CloneDetails", +"description": "Output only. If this volume is a clone, this field contains details about the clone.", +"readOnly": true +}, "coldTierSizeGib": { "description": "Output only. Size of the volume cold tier data rounded down to the nearest GiB.", "format": "int64", @@ -5392,6 +5662,10 @@ true "description": "Optional. Flag indicating if the volume will be a large capacity volume or a regular volume.", "type": "boolean" }, +"largeCapacityConfig": { +"$ref": "LargeCapacityConfig", +"description": "Optional. Large capacity config for the volume." +}, "ldapEnabled": { "description": "Output only. Flag indicating if the volume is NFS LDAP enabled or not.", "readOnly": true, From 02584f857bfd5d871596086ab789e34bfa7c0453 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 20/29] feat(networkmanagement): update the api #### networkmanagement:v1 The following keys were added: - schemas.NgfwPacketInspectionInfo (Total Keys: 3) - schemas.Step.properties.ngfwPacketInspection.$ref (Total Keys: 1) #### networkmanagement:v1beta1 The following keys were added: - schemas.NgfwPacketInspectionInfo (Total Keys: 3) - schemas.Step.properties.ngfwPacketInspection.$ref (Total Keys: 1) --- ...s.locations.global_.connectivityTests.html | 24 +++++++++++++++++++ ...s.locations.global_.connectivityTests.html | 24 +++++++++++++++++++ .../documents/networkmanagement.v1.json | 20 +++++++++++++++- .../documents/networkmanagement.v1beta1.json | 20 +++++++++++++++- 4 files changed, 86 insertions(+), 2 deletions(-) diff --git a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html index 9f2c19b274b..91dad4bf3d2 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html @@ -453,6 +453,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -796,6 +799,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -1342,6 +1348,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -1685,6 +1694,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -2222,6 +2234,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -2565,6 +2580,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -3061,6 +3079,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -3404,6 +3425,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. diff --git a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html index e6c24815c3c..d6aa3563e69 100644 --- a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html +++ b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html @@ -453,6 +453,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -796,6 +799,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -1342,6 +1348,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -1685,6 +1694,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -2222,6 +2234,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -2565,6 +2580,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -3061,6 +3079,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. @@ -3404,6 +3425,9 @@

Method Details

"region": "A String", # The region of the subnet matching the source IP address of the test. "uri": "A String", # URI of a Compute Engine network. }, + "ngfwPacketInspection": { # For display only. Metadata associated with a layer 7 packet inspection by the firewall. # Display information of a layer 7 packet inspection by the firewall. + "securityProfileGroupUri": "A String", # URI of the security profile group associated with this firewall packet inspection. + }, "projectId": "A String", # Project ID that contains the configuration this step is validating. "proxyConnection": { # For display only. Metadata associated with ProxyConnection. # Display information of a ProxyConnection. "networkUri": "A String", # URI of the network where connection is proxied. diff --git a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json index 8fad26f05cb..fb2ef5b008e 100644 --- a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json +++ b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json @@ -1237,7 +1237,7 @@ } } }, -"revision": "20260130", +"revision": "20260211", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -3326,6 +3326,17 @@ false }, "type": "object" }, +"NgfwPacketInspectionInfo": { +"description": "For display only. Metadata associated with a layer 7 packet inspection by the firewall.", +"id": "NgfwPacketInspectionInfo", +"properties": { +"securityProfileGroupUri": { +"description": "URI of the security profile group associated with this firewall packet inspection.", +"type": "string" +} +}, +"type": "object" +}, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -4124,6 +4135,10 @@ false "$ref": "NetworkInfo", "description": "Display information of a Google Cloud network." }, +"ngfwPacketInspection": { +"$ref": "NgfwPacketInspectionInfo", +"description": "Display information of a layer 7 packet inspection by the firewall." +}, "projectId": { "description": "Project ID that contains the configuration this step is validating.", "type": "string" @@ -4187,6 +4202,7 @@ false "ARRIVE_AT_VPC_CONNECTOR", "DIRECT_VPC_EGRESS_CONNECTION", "SERVERLESS_EXTERNAL_CONNECTION", +"NGFW_PACKET_INSPECTION", "NAT", "SKIP_GKE_POD_IP_MASQUERADING", "PROXY_CONNECTION", @@ -4236,6 +4252,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -4271,6 +4288,7 @@ false "Forwarding state: arriving at a VPC connector.", "Forwarding state: for packets originating from a serverless endpoint forwarded through Direct VPC egress.", "Forwarding state: for packets originating from a serverless endpoint forwarded through public (external) connectivity.", +"Forwarding state: Layer 7 packet inspection by the firewall endpoint based on the configured security profile group.", "Transition state: packet header translated. The `nat` field is populated with the translation information.", "Transition state: GKE Pod IP masquerading is skipped. The `ip_masquerading_skipped` field is populated with the reason.", "Transition state: original connection is terminated and a new proxied connection is initiated.", diff --git a/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json b/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json index ec4acfa06fc..00678dc5925 100644 --- a/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json @@ -1237,7 +1237,7 @@ } } }, -"revision": "20260130", +"revision": "20260211", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -3326,6 +3326,17 @@ false }, "type": "object" }, +"NgfwPacketInspectionInfo": { +"description": "For display only. Metadata associated with a layer 7 packet inspection by the firewall.", +"id": "NgfwPacketInspectionInfo", +"properties": { +"securityProfileGroupUri": { +"description": "URI of the security profile group associated with this firewall packet inspection.", +"type": "string" +} +}, +"type": "object" +}, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -4124,6 +4135,10 @@ false "$ref": "NetworkInfo", "description": "Display information of a Google Cloud network." }, +"ngfwPacketInspection": { +"$ref": "NgfwPacketInspectionInfo", +"description": "Display information of a layer 7 packet inspection by the firewall." +}, "projectId": { "description": "Project ID that contains the configuration this step is validating.", "type": "string" @@ -4187,6 +4202,7 @@ false "ARRIVE_AT_VPC_CONNECTOR", "DIRECT_VPC_EGRESS_CONNECTION", "SERVERLESS_EXTERNAL_CONNECTION", +"NGFW_PACKET_INSPECTION", "NAT", "SKIP_GKE_POD_IP_MASQUERADING", "PROXY_CONNECTION", @@ -4236,6 +4252,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -4271,6 +4288,7 @@ false "Forwarding state: arriving at a VPC connector.", "Forwarding state: for packets originating from a serverless endpoint forwarded through Direct VPC egress.", "Forwarding state: for packets originating from a serverless endpoint forwarded through public (external) connectivity.", +"Forwarding state: Layer 7 packet inspection by the firewall endpoint based on the configured security profile group.", "Transition state: packet header translated. The `nat` field is populated with the translation information.", "Transition state: GKE Pod IP masquerading is skipped. The `ip_masquerading_skipped` field is populated with the reason.", "Transition state: original connection is terminated and a new proxied connection is initiated.", From c0a4e808a52a034e4508549246e4ee3a0470ffdb Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 21/29] fix(oracledatabase): update the api #### oracledatabase:v1 The following keys were changed: - endpoints (Total Keys: 1) --- .../documents/oracledatabase.v1.json | 72 ++++++++++++++++++- 1 file changed, 71 insertions(+), 1 deletion(-) diff --git a/googleapiclient/discovery_cache/documents/oracledatabase.v1.json b/googleapiclient/discovery_cache/documents/oracledatabase.v1.json index cbdcf0fc159..e695e8cb8fe 100644 --- a/googleapiclient/discovery_cache/documents/oracledatabase.v1.json +++ b/googleapiclient/discovery_cache/documents/oracledatabase.v1.json @@ -18,8 +18,78 @@ "endpoints": [ { "description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.asia-northeast1.rep.googleapis.com/", +"location": "asia-northeast1" +}, +{ +"description": "Regional Endpoint", "endpointUrl": "https://oracledatabase.asia-northeast2.rep.googleapis.com/", "location": "asia-northeast2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.asia-south1.rep.googleapis.com/", +"location": "asia-south1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.asia-south2.rep.googleapis.com/", +"location": "asia-south2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.australia-southeast1.rep.googleapis.com/", +"location": "australia-southeast1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.australia-southeast2.rep.googleapis.com/", +"location": "australia-southeast2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.europe-west2.rep.googleapis.com/", +"location": "europe-west2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.europe-west3.rep.googleapis.com/", +"location": "europe-west3" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.europe-west8.rep.googleapis.com/", +"location": "europe-west8" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.northamerica-northeast1.rep.googleapis.com/", +"location": "northamerica-northeast1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.northamerica-northeast2.rep.googleapis.com/", +"location": "northamerica-northeast2" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.southamerica-east1.rep.googleapis.com/", +"location": "southamerica-east1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.us-central1.rep.googleapis.com/", +"location": "us-central1" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.us-east4.rep.googleapis.com/", +"location": "us-east4" +}, +{ +"description": "Regional Endpoint", +"endpointUrl": "https://oracledatabase.us-west3.rep.googleapis.com/", +"location": "us-west3" } ], "fullyEncodeReservedExpansion": true, @@ -2479,7 +2549,7 @@ } } }, -"revision": "20260212", +"revision": "20260220", "rootUrl": "https://oracledatabase.googleapis.com/", "schemas": { "AllConnectionStrings": { From d87d6abac6e2fb7c3e57234e87ed9f66d81a59a0 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:57 +0000 Subject: [PATCH 22/29] feat(playdeveloperreporting): update the api #### playdeveloperreporting:v1alpha1 The following keys were added: - schemas.ApiservingMcpMcpToolDataHandlingProfile (Total Keys: 4) --- .../playdeveloperreporting.v1alpha1.json | 53 ++++++++++++++++++- 1 file changed, 52 insertions(+), 1 deletion(-) diff --git a/googleapiclient/discovery_cache/documents/playdeveloperreporting.v1alpha1.json b/googleapiclient/discovery_cache/documents/playdeveloperreporting.v1alpha1.json index 95d7c70447c..a958840d2da 100644 --- a/googleapiclient/discovery_cache/documents/playdeveloperreporting.v1alpha1.json +++ b/googleapiclient/discovery_cache/documents/playdeveloperreporting.v1alpha1.json @@ -1004,9 +1004,60 @@ } } }, -"revision": "20260201", +"revision": "20260222", "rootUrl": "https://playdeveloperreporting.googleapis.com/", "schemas": { +"ApiservingMcpMcpToolDataHandlingProfile": { +"description": "Profile describing the data handling characteristics of an MCP tool. When used within the McpTool.meta field, this message should be packed into a google.protobuf.Any and associated with the key: \"google.com/tool.profiles/data_handling\"", +"id": "ApiservingMcpMcpToolDataHandlingProfile", +"properties": { +"inputDataAccessLevel": { +"description": "// The data access level of the tool's inputs.", +"enum": [ +"DATA_ACCESS_LEVEL_UNSPECIFIED", +"DATA_ACCESS_LEVEL_PUBLIC", +"DATA_ACCESS_LEVEL_CONFIDENTIAL", +"DATA_ACCESS_LEVEL_NEED_TO_KNOW", +"DATA_ACCESS_LEVEL_PII", +"DATA_ACCESS_LEVEL_USER", +"DATA_ACCESS_LEVEL_NO_DATA_ACCESS" +], +"enumDescriptions": [ +"The default value. This value is unused.", +"Public data.", +"Confidential data.", +"Need-to-know data.", +"Personally Identifiable Information (PII) data.", +"User data.", +"The tool does not access any data." +], +"type": "string" +}, +"outputDataAccessLevel": { +"description": "The data access level of the tool's outputs.", +"enum": [ +"DATA_ACCESS_LEVEL_UNSPECIFIED", +"DATA_ACCESS_LEVEL_PUBLIC", +"DATA_ACCESS_LEVEL_CONFIDENTIAL", +"DATA_ACCESS_LEVEL_NEED_TO_KNOW", +"DATA_ACCESS_LEVEL_PII", +"DATA_ACCESS_LEVEL_USER", +"DATA_ACCESS_LEVEL_NO_DATA_ACCESS" +], +"enumDescriptions": [ +"The default value. This value is unused.", +"Public data.", +"Confidential data.", +"Need-to-know data.", +"Personally Identifiable Information (PII) data.", +"User data.", +"The tool does not access any data." +], +"type": "string" +} +}, +"type": "object" +}, "GooglePlayDeveloperReportingV1alpha1Anomaly": { "description": "Represents an anomaly detected in a dataset. Our anomaly detection systems flag datapoints in a time series that fall outside of and expected range derived from historical data. Although those expected ranges have an upper and a lower bound, we only flag anomalies when the data has become unexpectedly _worse_, which usually corresponds to the case where the metric crosses the upper bound. Multiple contiguous datapoints in a timeline outside of the expected range will be grouped into a single anomaly. Therefore, an anomaly represents effectively a segment of a metric's timeline. The information stored in the `timeline_spec`, `dimensions` and `metric` can be used to fetch a full timeline with extended ragne for context. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1alpha1Anomaly", From 20bb4031e9d6bd4c1f834fc22e7f5d9eb79ef1d6 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:58 +0000 Subject: [PATCH 23/29] fix(run): update the api #### run:v1 The following keys were changed: - resources.namespaces.resources.authorizeddomains.methods.list.scopes (Total Keys: 1) - resources.namespaces.resources.domainmappings.methods.create.scopes (Total Keys: 1) - resources.namespaces.resources.domainmappings.methods.delete.scopes (Total Keys: 1) - resources.namespaces.resources.domainmappings.methods.get.scopes (Total Keys: 1) - resources.namespaces.resources.domainmappings.methods.list.scopes (Total Keys: 1) - resources.namespaces.resources.services.methods.create.scopes (Total Keys: 1) - resources.namespaces.resources.services.methods.delete.scopes (Total Keys: 1) - resources.namespaces.resources.services.methods.get.scopes (Total Keys: 1) - resources.namespaces.resources.services.methods.list.scopes (Total Keys: 1) - resources.namespaces.resources.services.methods.replaceService.scopes (Total Keys: 1) - resources.projects.resources.authorizeddomains.methods.list.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.authorizeddomains.methods.list.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.domainmappings.methods.create.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.domainmappings.methods.delete.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.domainmappings.methods.get.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.domainmappings.methods.list.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.create.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.delete.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.get.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.getIamPolicy.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.list.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.replaceService.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.setIamPolicy.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.testIamPermissions.scopes (Total Keys: 1) #### run:v2 The following keys were changed: - resources.projects.resources.locations.resources.services.methods.create.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.delete.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.get.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.getIamPolicy.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.list.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.patch.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.setIamPolicy.scopes (Total Keys: 1) - resources.projects.resources.locations.resources.services.methods.testIamPermissions.scopes (Total Keys: 1) --- .../run_v2.projects.locations.instances.html | 6 +- ...v2.projects.locations.jobs.executions.html | 4 +- ...jects.locations.jobs.executions.tasks.html | 4 +- docs/dyn/run_v2.projects.locations.jobs.html | 8 +- .../run_v2.projects.locations.services.html | 37 ++++---- ...projects.locations.services.revisions.html | 16 ++-- ...run_v2.projects.locations.workerPools.html | 8 +- ...jects.locations.workerPools.revisions.html | 16 ++-- .../discovery_cache/documents/run.v1.json | 87 +++++++++++++------ .../discovery_cache/documents/run.v2.json | 51 ++++++++--- 10 files changed, 149 insertions(+), 88 deletions(-) diff --git a/docs/dyn/run_v2.projects.locations.instances.html b/docs/dyn/run_v2.projects.locations.instances.html index 14541c64f1d..124a5f66238 100644 --- a/docs/dyn/run_v2.projects.locations.instances.html +++ b/docs/dyn/run_v2.projects.locations.instances.html @@ -318,7 +318,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -654,7 +654,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -928,7 +928,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, diff --git a/docs/dyn/run_v2.projects.locations.jobs.executions.html b/docs/dyn/run_v2.projects.locations.jobs.executions.html index 81dd5c30d27..00f283eea5f 100644 --- a/docs/dyn/run_v2.projects.locations.jobs.executions.html +++ b/docs/dyn/run_v2.projects.locations.jobs.executions.html @@ -421,7 +421,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -678,7 +678,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, diff --git a/docs/dyn/run_v2.projects.locations.jobs.executions.tasks.html b/docs/dyn/run_v2.projects.locations.jobs.executions.tasks.html index 439d4504294..e232795f0be 100644 --- a/docs/dyn/run_v2.projects.locations.jobs.executions.tasks.html +++ b/docs/dyn/run_v2.projects.locations.jobs.executions.tasks.html @@ -298,7 +298,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -560,7 +560,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, diff --git a/docs/dyn/run_v2.projects.locations.jobs.html b/docs/dyn/run_v2.projects.locations.jobs.html index adf8373b8b9..2f9ccaf12d3 100644 --- a/docs/dyn/run_v2.projects.locations.jobs.html +++ b/docs/dyn/run_v2.projects.locations.jobs.html @@ -328,7 +328,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -674,7 +674,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -1006,7 +1006,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -1297,7 +1297,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, diff --git a/docs/dyn/run_v2.projects.locations.services.html b/docs/dyn/run_v2.projects.locations.services.html index 2a5e6acb159..98d32d353f6 100644 --- a/docs/dyn/run_v2.projects.locations.services.html +++ b/docs/dyn/run_v2.projects.locations.services.html @@ -101,7 +101,7 @@

Instance Methods

list_next()

Retrieves the next page of results.

- patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None)

+ patch(name, allowMissing=None, body=None, forceNewRevision=None, updateMask=None, validateOnly=None, x__xgafv=None)

Updates a Service.

setIamPolicy(resource, body=None, x__xgafv=None)

@@ -203,7 +203,7 @@

Method Details

}, "client": "A String", # Optional. Arbitrary identifier for the API client. "clientVersion": "A String", # Optional. Arbitrary version identifier for the API client. - "containers": [ # Holds the single container that defines the unit of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -347,8 +347,8 @@

Method Details

}, "revision": "A String", # Optional. The unique name for the revision. If this field is omitted, it will be automatically generated based on the Service name. "scaling": { # Settings for revision-level scaling settings. # Optional. Scaling settings for this Revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -361,7 +361,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -606,7 +606,7 @@

Method Details

}, "client": "A String", # Optional. Arbitrary identifier for the API client. "clientVersion": "A String", # Optional. Arbitrary version identifier for the API client. - "containers": [ # Holds the single container that defines the unit of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -750,8 +750,8 @@

Method Details

}, "revision": "A String", # Optional. The unique name for the revision. If this field is omitted, it will be automatically generated based on the Service name. "scaling": { # Settings for revision-level scaling settings. # Optional. Scaling settings for this Revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -764,7 +764,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -996,7 +996,7 @@

Method Details

}, "client": "A String", # Optional. Arbitrary identifier for the API client. "clientVersion": "A String", # Optional. Arbitrary version identifier for the API client. - "containers": [ # Holds the single container that defines the unit of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -1140,8 +1140,8 @@

Method Details

}, "revision": "A String", # Optional. The unique name for the revision. If this field is omitted, it will be automatically generated based on the Service name. "scaling": { # Settings for revision-level scaling settings. # Optional. Scaling settings for this Revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -1154,7 +1154,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -1259,7 +1259,7 @@

Method Details

- patch(name, allowMissing=None, body=None, updateMask=None, validateOnly=None, x__xgafv=None) + patch(name, allowMissing=None, body=None, forceNewRevision=None, updateMask=None, validateOnly=None, x__xgafv=None)
Updates a Service.
 
 Args:
@@ -1346,7 +1346,7 @@ 

Method Details

}, "client": "A String", # Optional. Arbitrary identifier for the API client. "clientVersion": "A String", # Optional. Arbitrary version identifier for the API client. - "containers": [ # Holds the single container that defines the unit of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -1490,8 +1490,8 @@

Method Details

}, "revision": "A String", # Optional. The unique name for the revision. If this field is omitted, it will be automatically generated based on the Service name. "scaling": { # Settings for revision-level scaling settings. # Optional. Scaling settings for this Revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -1504,7 +1504,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -1589,6 +1589,7 @@

Method Details

} allowMissing: boolean, Optional. If set to true, and if the Service does not exist, it will create a new one. The caller must have 'run.services.create' permissions if this is set to true and the Service does not exist. + forceNewRevision: boolean, Optional. If set to true, a new revision will be created from the template even if the system doesn't detect any changes from the previously deployed revision. This may be useful for cases where the underlying resources need to be recreated or reinitialized. For example if the image is specified by label, but the underlying image digest has changed) or if the container performs deployment initialization work that needs to be performed again. updateMask: string, Optional. The list of fields to be updated. validateOnly: boolean, Indicates that the request should be validated and default values populated, without persisting the request or updating any resources. x__xgafv: string, V1 error format. diff --git a/docs/dyn/run_v2.projects.locations.services.revisions.html b/docs/dyn/run_v2.projects.locations.services.revisions.html index ea0cf8d470d..cc6e2dca774 100644 --- a/docs/dyn/run_v2.projects.locations.services.revisions.html +++ b/docs/dyn/run_v2.projects.locations.services.revisions.html @@ -203,7 +203,7 @@

Method Details

"type": "A String", # type is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * "Ready": True when the Resource is ready. }, ], - "containers": [ # Containers holds the list which define the units of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -357,8 +357,8 @@

Method Details

"reconciling": True or False, # Output only. Indicates whether the resource's reconciliation is still in progress. See comments in `Service.reconciling` for additional information on reconciliation process in Cloud Run. "satisfiesPzs": True or False, # Output only. Reserved for future use. "scaling": { # Settings for revision-level scaling settings. # Scaling settings for this revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -377,7 +377,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -465,7 +465,7 @@

Method Details

"type": "A String", # type is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * "Ready": True when the Resource is ready. }, ], - "containers": [ # Containers holds the list which define the units of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -619,8 +619,8 @@

Method Details

"reconciling": True or False, # Output only. Indicates whether the resource's reconciliation is still in progress. See comments in `Service.reconciling` for additional information on reconciliation process in Cloud Run. "satisfiesPzs": True or False, # Output only. Reserved for future use. "scaling": { # Settings for revision-level scaling settings. # Scaling settings for this revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -639,7 +639,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, diff --git a/docs/dyn/run_v2.projects.locations.workerPools.html b/docs/dyn/run_v2.projects.locations.workerPools.html index 77213eeeaca..697117f239b 100644 --- a/docs/dyn/run_v2.projects.locations.workerPools.html +++ b/docs/dyn/run_v2.projects.locations.workerPools.html @@ -338,7 +338,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -697,7 +697,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -1043,7 +1043,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -1346,7 +1346,7 @@

Method Details

"volumes": [ # Optional. A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, diff --git a/docs/dyn/run_v2.projects.locations.workerPools.revisions.html b/docs/dyn/run_v2.projects.locations.workerPools.revisions.html index 60f733def06..7f4b34db807 100644 --- a/docs/dyn/run_v2.projects.locations.workerPools.revisions.html +++ b/docs/dyn/run_v2.projects.locations.workerPools.revisions.html @@ -164,7 +164,7 @@

Method Details

"type": "A String", # type is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * "Ready": True when the Resource is ready. }, ], - "containers": [ # Containers holds the list which define the units of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -318,8 +318,8 @@

Method Details

"reconciling": True or False, # Output only. Indicates whether the resource's reconciliation is still in progress. See comments in `Service.reconciling` for additional information on reconciliation process in Cloud Run. "satisfiesPzs": True or False, # Output only. Reserved for future use. "scaling": { # Settings for revision-level scaling settings. # Scaling settings for this revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -338,7 +338,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, @@ -426,7 +426,7 @@

Method Details

"type": "A String", # type is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * "Ready": True when the Resource is ready. }, ], - "containers": [ # Containers holds the list which define the units of execution for this Revision. + "containers": [ # Holds the list which define the units of execution for this Revision. { # A single application container. This specifies both the container to run, the command to run in the container and the arguments to supply to it. Note that additional arguments can be supplied by the system to the container at runtime. "args": [ # Arguments to the entrypoint. The docker image's CMD is used if this is not provided. "A String", @@ -580,8 +580,8 @@

Method Details

"reconciling": True or False, # Output only. Indicates whether the resource's reconciliation is still in progress. See comments in `Service.reconciling` for additional information on reconciliation process in Cloud Run. "satisfiesPzs": True or False, # Output only. Reserved for future use. "scaling": { # Settings for revision-level scaling settings. # Scaling settings for this revision. - "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. - "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. + "concurrencyUtilization": 3.14, # Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling. + "cpuUtilization": 3.14, # Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling. "maxInstanceCount": 42, # Optional. Maximum number of serving instances that this resource should have. When unspecified, the field is set to the server default value of 100. For more information see https://cloud.google.com/run/docs/configuring/max-instances "minInstanceCount": 42, # Optional. Minimum number of serving instances that this resource should have. }, @@ -600,7 +600,7 @@

Method Details

"volumes": [ # A list of Volumes to make available to containers. { # Volume represents a named volume in a container. "cloudSqlInstance": { # Represents a set of Cloud SQL instances. Each one will be available under /cloudsql/[instance]. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. # For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. - "instances": [ # The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance} + "instances": [ # A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. "A String", ], }, diff --git a/googleapiclient/discovery_cache/documents/run.v1.json b/googleapiclient/discovery_cache/documents/run.v1.json index 3ca22bb2391..784dace8f67 100644 --- a/googleapiclient/discovery_cache/documents/run.v1.json +++ b/googleapiclient/discovery_cache/documents/run.v1.json @@ -620,7 +620,9 @@ "$ref": "ListAuthorizedDomainsResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] } } @@ -751,7 +753,8 @@ "$ref": "DomainMapping" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "delete": { @@ -796,7 +799,8 @@ "$ref": "Status" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "get": { @@ -821,7 +825,9 @@ "$ref": "DomainMapping" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -882,7 +888,9 @@ "$ref": "ListDomainMappingsResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] } } @@ -1730,7 +1738,8 @@ "$ref": "Service" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "delete": { @@ -1775,7 +1784,8 @@ "$ref": "Status" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "get": { @@ -1800,7 +1810,9 @@ "$ref": "Service" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -1861,7 +1873,9 @@ "$ref": "ListServicesResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "replaceService": { @@ -1894,7 +1908,8 @@ "$ref": "Service" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] } } @@ -2194,7 +2209,9 @@ "$ref": "ListAuthorizedDomainsResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] } } @@ -2285,7 +2302,9 @@ "$ref": "ListAuthorizedDomainsResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] } } @@ -2416,7 +2435,8 @@ "$ref": "DomainMapping" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "delete": { @@ -2461,7 +2481,8 @@ "$ref": "Status" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "get": { @@ -2486,7 +2507,9 @@ "$ref": "DomainMapping" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -2547,7 +2570,9 @@ "$ref": "ListDomainMappingsResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] } } @@ -3119,7 +3144,8 @@ "$ref": "Service" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "delete": { @@ -3164,7 +3190,8 @@ "$ref": "Status" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "get": { @@ -3189,7 +3216,9 @@ "$ref": "Service" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "getIamPolicy": { @@ -3220,7 +3249,9 @@ "$ref": "Policy" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -3281,7 +3312,9 @@ "$ref": "ListServicesResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "replaceService": { @@ -3314,7 +3347,8 @@ "$ref": "Service" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "setIamPolicy": { @@ -3342,7 +3376,8 @@ "$ref": "Policy" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "testIamPermissions": { @@ -3370,7 +3405,9 @@ "$ref": "TestIamPermissionsResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] } } @@ -3471,7 +3508,7 @@ } } }, -"revision": "20260206", +"revision": "20260213", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { diff --git a/googleapiclient/discovery_cache/documents/run.v2.json b/googleapiclient/discovery_cache/documents/run.v2.json index a64345f8ecc..53e2fbbf472 100644 --- a/googleapiclient/discovery_cache/documents/run.v2.json +++ b/googleapiclient/discovery_cache/documents/run.v2.json @@ -4,6 +4,12 @@ "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." +}, +"https://www.googleapis.com/auth/run": { +"description": "See, edit, configure, and delete your Google Cloud Run data and see the email address for your Google Account" +}, +"https://www.googleapis.com/auth/run.readonly": { +"description": "See your Google Cloud Run data and the email address of your Google Account" } } } @@ -1615,7 +1621,8 @@ "$ref": "GoogleLongrunningOperation" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "delete": { @@ -1650,7 +1657,8 @@ "$ref": "GoogleLongrunningOperation" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "get": { @@ -1675,7 +1683,9 @@ "$ref": "GoogleCloudRunV2Service" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "getIamPolicy": { @@ -1706,7 +1716,9 @@ "$ref": "GoogleIamV1Policy" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -1747,7 +1759,9 @@ "$ref": "GoogleCloudRunV2ListServicesResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] }, "patch": { @@ -1764,6 +1778,11 @@ "location": "query", "type": "boolean" }, +"forceNewRevision": { +"description": "Optional. If set to true, a new revision will be created from the template even if the system doesn't detect any changes from the previously deployed revision. This may be useful for cases where the underlying resources need to be recreated or reinitialized. For example if the image is specified by label, but the underlying image digest has changed) or if the container performs deployment initialization work that needs to be performed again.", +"location": "query", +"type": "boolean" +}, "name": { "description": "Identifier. The fully qualified name of this Service. In CreateServiceRequest, this field is ignored, and instead composed from CreateServiceRequest.parent and CreateServiceRequest.service_id. Format: projects/{project}/locations/{location}/services/{service_id}", "location": "path", @@ -1791,7 +1810,8 @@ "$ref": "GoogleLongrunningOperation" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "setIamPolicy": { @@ -1819,7 +1839,8 @@ "$ref": "GoogleIamV1Policy" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run" ] }, "testIamPermissions": { @@ -1847,7 +1868,9 @@ "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/run", +"https://www.googleapis.com/auth/run.readonly" ] } }, @@ -2383,7 +2406,7 @@ } } }, -"revision": "20260206", +"revision": "20260213", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -2528,7 +2551,7 @@ "id": "GoogleCloudRunV2CloudSqlInstance", "properties": { "instances": { -"description": "The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance}", +"description": "A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \\ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run.", "items": { "type": "string" }, @@ -4171,7 +4194,7 @@ "type": "array" }, "containers": { -"description": "Containers holds the list which define the units of execution for this Revision.", +"description": "Holds the list which define the units of execution for this Revision.", "items": { "$ref": "GoogleCloudRunV2Container" }, @@ -4381,12 +4404,12 @@ "id": "GoogleCloudRunV2RevisionScaling", "properties": { "concurrencyUtilization": { -"description": "Optional. Determines a threshold for concurrency utilization before scaling begins.", +"description": "Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling.", "format": "float", "type": "number" }, "cpuUtilization": { -"description": "Optional. Determines a threshold for CPU utilization before scaling begins.", +"description": "Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling.", "format": "float", "type": "number" }, @@ -4435,7 +4458,7 @@ "type": "string" }, "containers": { -"description": "Holds the single container that defines the unit of execution for this Revision.", +"description": "Holds the list which define the units of execution for this Revision.", "items": { "$ref": "GoogleCloudRunV2Container" }, From 7625ec67046351ebb36fb45d6721f1bafd815cb4 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:58 +0000 Subject: [PATCH 24/29] feat(secretmanager): update the api #### secretmanager:v1 The following keys were deleted: - resources.projects.resources.locations.resources.operations.methods.cancel (Total Keys: 11) - resources.projects.resources.locations.resources.operations.methods.delete (Total Keys: 11) - resources.projects.resources.locations.resources.operations.methods.get (Total Keys: 11) - resources.projects.resources.locations.resources.operations.methods.list (Total Keys: 20) - schemas.ListOperationsResponse (Total Keys: 7) #### secretmanager:v1beta2 The following keys were deleted: - resources.projects.resources.locations.resources.operations.methods.cancel (Total Keys: 11) - resources.projects.resources.locations.resources.operations.methods.delete (Total Keys: 11) - resources.projects.resources.locations.resources.operations.methods.get (Total Keys: 11) - resources.projects.resources.locations.resources.operations.methods.list (Total Keys: 20) - schemas.ListOperationsResponse (Total Keys: 7) --- .../secretmanager_v1.projects.locations.html | 5 - ...retmanager_v1beta2.projects.locations.html | 5 - .../documents/secretmanager.v1.json | 152 +----------------- .../documents/secretmanager.v1beta2.json | 152 +----------------- 4 files changed, 2 insertions(+), 312 deletions(-) diff --git a/docs/dyn/secretmanager_v1.projects.locations.html b/docs/dyn/secretmanager_v1.projects.locations.html index 59a147d3aa8..11495859336 100644 --- a/docs/dyn/secretmanager_v1.projects.locations.html +++ b/docs/dyn/secretmanager_v1.projects.locations.html @@ -74,11 +74,6 @@

Secret Manager API . projects . locations

Instance Methods

-

- operations() -

-

Returns the operations Resource.

-

secrets()

diff --git a/docs/dyn/secretmanager_v1beta2.projects.locations.html b/docs/dyn/secretmanager_v1beta2.projects.locations.html index d6df9e114c0..ee81b53a5d3 100644 --- a/docs/dyn/secretmanager_v1beta2.projects.locations.html +++ b/docs/dyn/secretmanager_v1beta2.projects.locations.html @@ -74,11 +74,6 @@

Secret Manager API . projects . locations

Instance Methods

-

- operations() -

-

Returns the operations Resource.

-

secrets()

diff --git a/googleapiclient/discovery_cache/documents/secretmanager.v1.json b/googleapiclient/discovery_cache/documents/secretmanager.v1.json index eb0d15d7823..e561e1412a9 100644 --- a/googleapiclient/discovery_cache/documents/secretmanager.v1.json +++ b/googleapiclient/discovery_cache/documents/secretmanager.v1.json @@ -435,131 +435,6 @@ } }, "resources": { -"operations": { -"methods": { -"cancel": { -"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", -"httpMethod": "POST", -"id": "secretmanager.projects.locations.operations.cancel", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "The name of the operation resource to be cancelled.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+name}:cancel", -"response": { -"$ref": "Empty" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"delete": { -"description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", -"httpMethod": "DELETE", -"id": "secretmanager.projects.locations.operations.delete", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "The name of the operation resource to be deleted.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+name}", -"response": { -"$ref": "Empty" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"get": { -"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", -"httpMethod": "GET", -"id": "secretmanager.projects.locations.operations.get", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "The name of the operation resource.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+name}", -"response": { -"$ref": "Operation" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"list": { -"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", -"httpMethod": "GET", -"id": "secretmanager.projects.locations.operations.list", -"parameterOrder": [ -"name" -], -"parameters": { -"filter": { -"description": "The standard list filter.", -"location": "query", -"type": "string" -}, -"name": { -"description": "The name of the operation's parent resource.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+$", -"required": true, -"type": "string" -}, -"pageSize": { -"description": "The standard list page size.", -"format": "int32", -"location": "query", -"type": "integer" -}, -"pageToken": { -"description": "The standard list page token.", -"location": "query", -"type": "string" -}, -"returnPartialSuccess": { -"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", -"location": "query", -"type": "boolean" -} -}, -"path": "v1/{+name}/operations", -"response": { -"$ref": "ListOperationsResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -} -} -}, "secrets": { "methods": { "addVersion": { @@ -1491,7 +1366,7 @@ } } }, -"revision": "20260127", +"revision": "20260213", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -1715,31 +1590,6 @@ }, "type": "object" }, -"ListOperationsResponse": { -"description": "The response message for Operations.ListOperations.", -"id": "ListOperationsResponse", -"properties": { -"nextPageToken": { -"description": "The standard List next-page token.", -"type": "string" -}, -"operations": { -"description": "A list of operations that matches the specified filter in the request.", -"items": { -"$ref": "Operation" -}, -"type": "array" -}, -"unreachable": { -"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", -"items": { -"type": "string" -}, -"type": "array" -} -}, -"type": "object" -}, "ListSecretVersionsResponse": { "description": "Response message for SecretManagerService.ListSecretVersions.", "id": "ListSecretVersionsResponse", diff --git a/googleapiclient/discovery_cache/documents/secretmanager.v1beta2.json b/googleapiclient/discovery_cache/documents/secretmanager.v1beta2.json index 8f7f485adca..9e053c42f61 100644 --- a/googleapiclient/discovery_cache/documents/secretmanager.v1beta2.json +++ b/googleapiclient/discovery_cache/documents/secretmanager.v1beta2.json @@ -435,131 +435,6 @@ } }, "resources": { -"operations": { -"methods": { -"cancel": { -"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", -"flatPath": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", -"httpMethod": "POST", -"id": "secretmanager.projects.locations.operations.cancel", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "The name of the operation resource to be cancelled.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1beta2/{+name}:cancel", -"response": { -"$ref": "Empty" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"delete": { -"description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", -"flatPath": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", -"httpMethod": "DELETE", -"id": "secretmanager.projects.locations.operations.delete", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "The name of the operation resource to be deleted.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1beta2/{+name}", -"response": { -"$ref": "Empty" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"get": { -"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", -"flatPath": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", -"httpMethod": "GET", -"id": "secretmanager.projects.locations.operations.get", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "The name of the operation resource.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1beta2/{+name}", -"response": { -"$ref": "Operation" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"list": { -"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", -"flatPath": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations", -"httpMethod": "GET", -"id": "secretmanager.projects.locations.operations.list", -"parameterOrder": [ -"name" -], -"parameters": { -"filter": { -"description": "The standard list filter.", -"location": "query", -"type": "string" -}, -"name": { -"description": "The name of the operation's parent resource.", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+$", -"required": true, -"type": "string" -}, -"pageSize": { -"description": "The standard list page size.", -"format": "int32", -"location": "query", -"type": "integer" -}, -"pageToken": { -"description": "The standard list page token.", -"location": "query", -"type": "string" -}, -"returnPartialSuccess": { -"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", -"location": "query", -"type": "boolean" -} -}, -"path": "v1beta2/{+name}/operations", -"response": { -"$ref": "ListOperationsResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -} -} -}, "secrets": { "methods": { "addVersion": { @@ -1491,7 +1366,7 @@ } } }, -"revision": "20260127", +"revision": "20260213", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -1715,31 +1590,6 @@ }, "type": "object" }, -"ListOperationsResponse": { -"description": "The response message for Operations.ListOperations.", -"id": "ListOperationsResponse", -"properties": { -"nextPageToken": { -"description": "The standard List next-page token.", -"type": "string" -}, -"operations": { -"description": "A list of operations that matches the specified filter in the request.", -"items": { -"$ref": "Operation" -}, -"type": "array" -}, -"unreachable": { -"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", -"items": { -"type": "string" -}, -"type": "array" -} -}, -"type": "object" -}, "ListSecretVersionsResponse": { "description": "Response message for SecretManagerService.ListSecretVersions.", "id": "ListSecretVersionsResponse", From 67accfd163e39180400d52dd022d2a2e0b19c9ef Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:58 +0000 Subject: [PATCH 25/29] feat(securitycenter): update the api #### securitycenter:v1 The following keys were added: - schemas.ExternalExposure (Total Keys: 14) - schemas.Finding.properties.externalExposure.$ref (Total Keys: 1) - schemas.GoogleCloudSecuritycenterV2ExternalExposure (Total Keys: 14) - schemas.GoogleCloudSecuritycenterV2Finding.properties.externalExposure.$ref (Total Keys: 1) #### securitycenter:v1beta1 The following keys were added: - schemas.ExternalExposure (Total Keys: 14) - schemas.Finding.properties.externalExposure.$ref (Total Keys: 1) - schemas.GoogleCloudSecuritycenterV2ExternalExposure (Total Keys: 14) - schemas.GoogleCloudSecuritycenterV2Finding.properties.externalExposure.$ref (Total Keys: 1) #### securitycenter:v1beta2 The following keys were added: - schemas.ExternalExposure (Total Keys: 14) - schemas.Finding.properties.externalExposure.$ref (Total Keys: 1) - schemas.GoogleCloudSecuritycenterV2ExternalExposure (Total Keys: 14) - schemas.GoogleCloudSecuritycenterV2Finding.properties.externalExposure.$ref (Total Keys: 1) --- ...HealthAnalyticsSettings.customModules.html | 14 ++ ...itycenter_v1.folders.sources.findings.html | 70 ++++++++++ ...HealthAnalyticsSettings.customModules.html | 14 ++ ...ter_v1.organizations.sources.findings.html | 98 +++++++++++++ ...HealthAnalyticsSettings.customModules.html | 14 ++ ...tycenter_v1.projects.sources.findings.html | 70 ++++++++++ .../documents/securitycenter.v1.json | 132 +++++++++++++++++- .../documents/securitycenter.v1beta1.json | 132 +++++++++++++++++- .../documents/securitycenter.v1beta2.json | 132 +++++++++++++++++- 9 files changed, 661 insertions(+), 15 deletions(-) diff --git a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html index b107185a0d3..73eff5d4817 100644 --- a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html @@ -876,6 +876,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. diff --git a/docs/dyn/securitycenter_v1.folders.sources.findings.html b/docs/dyn/securitycenter_v1.folders.sources.findings.html index a03e478386b..df8d3dffeec 100644 --- a/docs/dyn/securitycenter_v1.folders.sources.findings.html +++ b/docs/dyn/securitycenter_v1.folders.sources.findings.html @@ -445,6 +445,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -1358,6 +1372,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -2127,6 +2155,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -2909,6 +2951,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -3692,6 +3748,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. diff --git a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html index 452114fd745..efbae1e39ef 100644 --- a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html @@ -876,6 +876,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. diff --git a/docs/dyn/securitycenter_v1.organizations.sources.findings.html b/docs/dyn/securitycenter_v1.organizations.sources.findings.html index ec69d55cac1..19e165879bb 100644 --- a/docs/dyn/securitycenter_v1.organizations.sources.findings.html +++ b/docs/dyn/securitycenter_v1.organizations.sources.findings.html @@ -378,6 +378,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -1147,6 +1161,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -1987,6 +2015,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -2900,6 +2942,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -3669,6 +3725,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -4451,6 +4521,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -5234,6 +5318,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. diff --git a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html index ba2f5763777..f0628d535c3 100644 --- a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html +++ b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html @@ -876,6 +876,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. diff --git a/docs/dyn/securitycenter_v1.projects.sources.findings.html b/docs/dyn/securitycenter_v1.projects.sources.findings.html index 0fdbfb8ddf9..d02a3a25650 100644 --- a/docs/dyn/securitycenter_v1.projects.sources.findings.html +++ b/docs/dyn/securitycenter_v1.projects.sources.findings.html @@ -445,6 +445,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -1358,6 +1372,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -2127,6 +2155,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -2909,6 +2951,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. @@ -3692,6 +3748,20 @@

Method Details

], "totalExfiltratedBytes": "A String", # Total exfiltrated bytes processed for the entire job. }, + "externalExposure": { # Details about the externally exposed resource associated with the finding. # External exposure associated with the finding. + "backendService": "A String", # The full resource name of load balancer backend service, for example, "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}". + "exposedEndpoint": "A String", # The resource which is running the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.” + "exposedService": "A String", # The name and version of the service, for example, "Jupyter Notebook 6.14.0". + "forwardingRule": "A String", # The full resource name of the forwarding rule, for example, "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}". + "instanceGroup": "A String", # The full resource name of the instance group, for example, "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}". + "loadBalancerFirewallPolicy": "A String", # The full resource name of the load balancer firewall policy, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + "networkEndpointGroup": "A String", # The full resource name of the network endpoint group, for example, "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}". + "privateIpAddress": "A String", # Private IP address of the exposed endpoint. + "privatePort": "A String", # Port number associated with private IP address. + "publicIpAddress": "A String", # Public IP address of the exposed endpoint. + "publicPort": "A String", # Public port number of the exposed endpoint. + "serviceFirewallPolicy": "A String", # The full resource name of the firewall policy of the exposed service, for example, "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}". + }, "externalSystems": { # Output only. Third party SIEM/SOAR fields within SCC, contains external system information and external system finding fields. "a_key": { # Representation of third party SIEM/SOAR fields within SCC. "assignees": [ # References primary/secondary etc assignees in the external system. diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1.json b/googleapiclient/discovery_cache/documents/securitycenter.v1.json index 06b3af21478..13a9f075203 100644 --- a/googleapiclient/discovery_cache/documents/securitycenter.v1.json +++ b/googleapiclient/discovery_cache/documents/securitycenter.v1.json @@ -5944,7 +5944,7 @@ } } }, -"revision": "20260123", +"revision": "20260219", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -7958,6 +7958,61 @@ }, "type": "object" }, +"ExternalExposure": { +"description": "Details about the externally exposed resource associated with the finding.", +"id": "ExternalExposure", +"properties": { +"backendService": { +"description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", +"type": "string" +}, +"exposedEndpoint": { +"description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.\u201d", +"type": "string" +}, +"exposedService": { +"description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", +"type": "string" +}, +"forwardingRule": { +"description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", +"type": "string" +}, +"instanceGroup": { +"description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", +"type": "string" +}, +"loadBalancerFirewallPolicy": { +"description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +}, +"networkEndpointGroup": { +"description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", +"type": "string" +}, +"privateIpAddress": { +"description": "Private IP address of the exposed endpoint.", +"type": "string" +}, +"privatePort": { +"description": "Port number associated with private IP address.", +"type": "string" +}, +"publicIpAddress": { +"description": "Public IP address of the exposed endpoint.", +"type": "string" +}, +"publicPort": { +"description": "Public port number of the exposed endpoint.", +"type": "string" +}, +"serviceFirewallPolicy": { +"description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +} +}, +"type": "object" +}, "File": { "description": "File information about the related binary/library used by an executable, or the script used by a script interpreter", "id": "File", @@ -8179,6 +8234,10 @@ "$ref": "Exfiltration", "description": "Represents exfiltrations associated with the finding." }, +"externalExposure": { +"$ref": "ExternalExposure", +"description": "External exposure associated with the finding." +}, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV1ExternalSystem" @@ -8210,7 +8269,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", -"CHOKEPOINT" +"CHOKEPOINT", +"EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -8222,7 +8282,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination.", "Describes a potential security risk to data assets that contain sensitive data.", -"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." +"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", +"Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, @@ -11102,6 +11163,61 @@ }, "type": "object" }, +"GoogleCloudSecuritycenterV2ExternalExposure": { +"description": "Details about the externally exposed resource associated with the finding.", +"id": "GoogleCloudSecuritycenterV2ExternalExposure", +"properties": { +"backendService": { +"description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", +"type": "string" +}, +"exposedEndpoint": { +"description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.\u201d", +"type": "string" +}, +"exposedService": { +"description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", +"type": "string" +}, +"forwardingRule": { +"description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", +"type": "string" +}, +"instanceGroup": { +"description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", +"type": "string" +}, +"loadBalancerFirewallPolicy": { +"description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +}, +"networkEndpointGroup": { +"description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", +"type": "string" +}, +"privateIpAddress": { +"description": "Private IP address of the exposed endpoint.", +"type": "string" +}, +"privatePort": { +"description": "Port number associated with private IP address.", +"type": "string" +}, +"publicIpAddress": { +"description": "Public IP address of the exposed endpoint.", +"type": "string" +}, +"publicPort": { +"description": "Public port number of the exposed endpoint.", +"type": "string" +}, +"serviceFirewallPolicy": { +"description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudSecuritycenterV2ExternalSystem": { "description": "Representation of third party SIEM/SOAR fields within SCC.", "id": "GoogleCloudSecuritycenterV2ExternalSystem", @@ -11388,6 +11504,10 @@ "$ref": "GoogleCloudSecuritycenterV2Exfiltration", "description": "Represents exfiltrations associated with the finding." }, +"externalExposure": { +"$ref": "GoogleCloudSecuritycenterV2ExternalExposure", +"description": "External exposure associated with the finding." +}, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV2ExternalSystem" @@ -11419,7 +11539,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", -"CHOKEPOINT" +"CHOKEPOINT", +"EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -11431,7 +11552,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a combination of security issues that represent a more severe security problem when taken together.", "Describes a potential security risk to data assets that contain sensitive data.", -"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." +"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", +"Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json b/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json index bcc26f85716..260120accaa 100644 --- a/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json @@ -919,7 +919,7 @@ } } }, -"revision": "20260123", +"revision": "20260219", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -2547,6 +2547,61 @@ }, "type": "object" }, +"ExternalExposure": { +"description": "Details about the externally exposed resource associated with the finding.", +"id": "ExternalExposure", +"properties": { +"backendService": { +"description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", +"type": "string" +}, +"exposedEndpoint": { +"description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.\u201d", +"type": "string" +}, +"exposedService": { +"description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", +"type": "string" +}, +"forwardingRule": { +"description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", +"type": "string" +}, +"instanceGroup": { +"description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", +"type": "string" +}, +"loadBalancerFirewallPolicy": { +"description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +}, +"networkEndpointGroup": { +"description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", +"type": "string" +}, +"privateIpAddress": { +"description": "Private IP address of the exposed endpoint.", +"type": "string" +}, +"privatePort": { +"description": "Port number associated with private IP address.", +"type": "string" +}, +"publicIpAddress": { +"description": "Public IP address of the exposed endpoint.", +"type": "string" +}, +"publicPort": { +"description": "Public port number of the exposed endpoint.", +"type": "string" +}, +"serviceFirewallPolicy": { +"description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +} +}, +"type": "object" +}, "File": { "description": "File information about the related binary/library used by an executable, or the script used by a script interpreter", "id": "File", @@ -2768,6 +2823,10 @@ "$ref": "Exfiltration", "description": "Represents exfiltrations associated with the finding." }, +"externalExposure": { +"$ref": "ExternalExposure", +"description": "External exposure associated with the finding." +}, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV1ExternalSystem" @@ -2799,7 +2858,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", -"CHOKEPOINT" +"CHOKEPOINT", +"EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -2811,7 +2871,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination.", "Describes a potential security risk to data assets that contain sensitive data.", -"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." +"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", +"Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, @@ -5772,6 +5833,61 @@ }, "type": "object" }, +"GoogleCloudSecuritycenterV2ExternalExposure": { +"description": "Details about the externally exposed resource associated with the finding.", +"id": "GoogleCloudSecuritycenterV2ExternalExposure", +"properties": { +"backendService": { +"description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", +"type": "string" +}, +"exposedEndpoint": { +"description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.\u201d", +"type": "string" +}, +"exposedService": { +"description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", +"type": "string" +}, +"forwardingRule": { +"description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", +"type": "string" +}, +"instanceGroup": { +"description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", +"type": "string" +}, +"loadBalancerFirewallPolicy": { +"description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +}, +"networkEndpointGroup": { +"description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", +"type": "string" +}, +"privateIpAddress": { +"description": "Private IP address of the exposed endpoint.", +"type": "string" +}, +"privatePort": { +"description": "Port number associated with private IP address.", +"type": "string" +}, +"publicIpAddress": { +"description": "Public IP address of the exposed endpoint.", +"type": "string" +}, +"publicPort": { +"description": "Public port number of the exposed endpoint.", +"type": "string" +}, +"serviceFirewallPolicy": { +"description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudSecuritycenterV2ExternalSystem": { "description": "Representation of third party SIEM/SOAR fields within SCC.", "id": "GoogleCloudSecuritycenterV2ExternalSystem", @@ -6058,6 +6174,10 @@ "$ref": "GoogleCloudSecuritycenterV2Exfiltration", "description": "Represents exfiltrations associated with the finding." }, +"externalExposure": { +"$ref": "GoogleCloudSecuritycenterV2ExternalExposure", +"description": "External exposure associated with the finding." +}, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV2ExternalSystem" @@ -6089,7 +6209,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", -"CHOKEPOINT" +"CHOKEPOINT", +"EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -6101,7 +6222,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a combination of security issues that represent a more severe security problem when taken together.", "Describes a potential security risk to data assets that contain sensitive data.", -"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." +"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", +"Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json b/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json index ae6cd6263c5..64354bc4caf 100644 --- a/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json +++ b/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json @@ -2003,7 +2003,7 @@ } } }, -"revision": "20260123", +"revision": "20260219", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -3638,6 +3638,61 @@ }, "type": "object" }, +"ExternalExposure": { +"description": "Details about the externally exposed resource associated with the finding.", +"id": "ExternalExposure", +"properties": { +"backendService": { +"description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", +"type": "string" +}, +"exposedEndpoint": { +"description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.\u201d", +"type": "string" +}, +"exposedService": { +"description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", +"type": "string" +}, +"forwardingRule": { +"description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", +"type": "string" +}, +"instanceGroup": { +"description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", +"type": "string" +}, +"loadBalancerFirewallPolicy": { +"description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +}, +"networkEndpointGroup": { +"description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", +"type": "string" +}, +"privateIpAddress": { +"description": "Private IP address of the exposed endpoint.", +"type": "string" +}, +"privatePort": { +"description": "Port number associated with private IP address.", +"type": "string" +}, +"publicIpAddress": { +"description": "Public IP address of the exposed endpoint.", +"type": "string" +}, +"publicPort": { +"description": "Public port number of the exposed endpoint.", +"type": "string" +}, +"serviceFirewallPolicy": { +"description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +} +}, +"type": "object" +}, "File": { "description": "File information about the related binary/library used by an executable, or the script used by a script interpreter", "id": "File", @@ -3859,6 +3914,10 @@ "$ref": "Exfiltration", "description": "Represents exfiltrations associated with the finding." }, +"externalExposure": { +"$ref": "ExternalExposure", +"description": "External exposure associated with the finding." +}, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV1ExternalSystem" @@ -3890,7 +3949,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", -"CHOKEPOINT" +"CHOKEPOINT", +"EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -3902,7 +3962,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination.", "Describes a potential security risk to data assets that contain sensitive data.", -"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." +"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", +"Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, @@ -6759,6 +6820,61 @@ }, "type": "object" }, +"GoogleCloudSecuritycenterV2ExternalExposure": { +"description": "Details about the externally exposed resource associated with the finding.", +"id": "GoogleCloudSecuritycenterV2ExternalExposure", +"properties": { +"backendService": { +"description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", +"type": "string" +}, +"exposedEndpoint": { +"description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.\u201d", +"type": "string" +}, +"exposedService": { +"description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", +"type": "string" +}, +"forwardingRule": { +"description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", +"type": "string" +}, +"instanceGroup": { +"description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", +"type": "string" +}, +"loadBalancerFirewallPolicy": { +"description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +}, +"networkEndpointGroup": { +"description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", +"type": "string" +}, +"privateIpAddress": { +"description": "Private IP address of the exposed endpoint.", +"type": "string" +}, +"privatePort": { +"description": "Port number associated with private IP address.", +"type": "string" +}, +"publicIpAddress": { +"description": "Public IP address of the exposed endpoint.", +"type": "string" +}, +"publicPort": { +"description": "Public port number of the exposed endpoint.", +"type": "string" +}, +"serviceFirewallPolicy": { +"description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudSecuritycenterV2ExternalSystem": { "description": "Representation of third party SIEM/SOAR fields within SCC.", "id": "GoogleCloudSecuritycenterV2ExternalSystem", @@ -7045,6 +7161,10 @@ "$ref": "GoogleCloudSecuritycenterV2Exfiltration", "description": "Represents exfiltrations associated with the finding." }, +"externalExposure": { +"$ref": "GoogleCloudSecuritycenterV2ExternalExposure", +"description": "External exposure associated with the finding." +}, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV2ExternalSystem" @@ -7076,7 +7196,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", -"CHOKEPOINT" +"CHOKEPOINT", +"EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -7088,7 +7209,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a combination of security issues that represent a more severe security problem when taken together.", "Describes a potential security risk to data assets that contain sensitive data.", -"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." +"Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", +"Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, From f2eb8d9a33acfb00c05fbe7030e9007e26167939 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:58 +0000 Subject: [PATCH 26/29] feat(servicemanagement): update the api #### servicemanagement:v1 The following keys were added: - schemas.Aspect.properties.rules (Total Keys: 2) - schemas.AspectRule (Total Keys: 5) --- ...servicemanagement_v1.services.configs.html | 32 +++++++++++++++++++ docs/dyn/servicemanagement_v1.services.html | 8 +++++ .../documents/servicemanagement.v1.json | 28 +++++++++++++++- 3 files changed, 67 insertions(+), 1 deletion(-) diff --git a/docs/dyn/servicemanagement_v1.services.configs.html b/docs/dyn/servicemanagement_v1.services.configs.html index f5c96b9b109..aef06cb1161 100644 --- a/docs/dyn/servicemanagement_v1.services.configs.html +++ b/docs/dyn/servicemanagement_v1.services.configs.html @@ -155,6 +155,14 @@

Method Details

"aspects": [ # Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners. { # Aspect represents Generic aspect. It is used to configure an aspect without making direct changes to service.proto "kind": "A String", # The type of this aspect configuration. + "rules": [ # Optional. Rules of the Configuration. + { # Rule-based configuration for an aspect. + "config": { # Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. + "a_key": "", # Properties of the object. + }, + "selector": "A String", # Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details. + }, + ], "spec": { # Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. "a_key": "", # Properties of the object. }, @@ -861,6 +869,14 @@

Method Details

"aspects": [ # Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners. { # Aspect represents Generic aspect. It is used to configure an aspect without making direct changes to service.proto "kind": "A String", # The type of this aspect configuration. + "rules": [ # Optional. Rules of the Configuration. + { # Rule-based configuration for an aspect. + "config": { # Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. + "a_key": "", # Properties of the object. + }, + "selector": "A String", # Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details. + }, + ], "spec": { # Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. "a_key": "", # Properties of the object. }, @@ -1579,6 +1595,14 @@

Method Details

"aspects": [ # Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners. { # Aspect represents Generic aspect. It is used to configure an aspect without making direct changes to service.proto "kind": "A String", # The type of this aspect configuration. + "rules": [ # Optional. Rules of the Configuration. + { # Rule-based configuration for an aspect. + "config": { # Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. + "a_key": "", # Properties of the object. + }, + "selector": "A String", # Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details. + }, + ], "spec": { # Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. "a_key": "", # Properties of the object. }, @@ -2297,6 +2321,14 @@

Method Details

"aspects": [ # Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners. { # Aspect represents Generic aspect. It is used to configure an aspect without making direct changes to service.proto "kind": "A String", # The type of this aspect configuration. + "rules": [ # Optional. Rules of the Configuration. + { # Rule-based configuration for an aspect. + "config": { # Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. + "a_key": "", # Properties of the object. + }, + "selector": "A String", # Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details. + }, + ], "spec": { # Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/servicemanagement_v1.services.html b/docs/dyn/servicemanagement_v1.services.html index 363a18bd7db..1f814fb2ed0 100644 --- a/docs/dyn/servicemanagement_v1.services.html +++ b/docs/dyn/servicemanagement_v1.services.html @@ -350,6 +350,14 @@

Method Details

"aspects": [ # Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners. { # Aspect represents Generic aspect. It is used to configure an aspect without making direct changes to service.proto "kind": "A String", # The type of this aspect configuration. + "rules": [ # Optional. Rules of the Configuration. + { # Rule-based configuration for an aspect. + "config": { # Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. + "a_key": "", # Properties of the object. + }, + "selector": "A String", # Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details. + }, + ], "spec": { # Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`. "a_key": "", # Properties of the object. }, diff --git a/googleapiclient/discovery_cache/documents/servicemanagement.v1.json b/googleapiclient/discovery_cache/documents/servicemanagement.v1.json index 06b63044339..4c61e96e46a 100644 --- a/googleapiclient/discovery_cache/documents/servicemanagement.v1.json +++ b/googleapiclient/discovery_cache/documents/servicemanagement.v1.json @@ -835,7 +835,7 @@ } } }, -"revision": "20260129", +"revision": "20260219", "rootUrl": "https://servicemanagement.googleapis.com/", "schemas": { "Advice": { @@ -915,6 +915,13 @@ "description": "The type of this aspect configuration.", "type": "string" }, +"rules": { +"description": "Optional. Rules of the Configuration.", +"items": { +"$ref": "AspectRule" +}, +"type": "array" +}, "spec": { "additionalProperties": { "description": "Properties of the object.", @@ -926,6 +933,25 @@ }, "type": "object" }, +"AspectRule": { +"description": "Rule-based configuration for an aspect.", +"id": "AspectRule", +"properties": { +"config": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`.", +"type": "object" +}, +"selector": { +"description": "Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details.", +"type": "string" +} +}, +"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", From 0be5489143e1c5ae1ba9145fe24de8d75c816e72 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:58 +0000 Subject: [PATCH 27/29] feat(servicenetworking): update the api #### servicenetworking:v1 The following keys were added: - schemas.Aspect.properties.rules (Total Keys: 2) - schemas.AspectRule (Total Keys: 5) #### servicenetworking:v1beta The following keys were added: - schemas.Aspect.properties.rules (Total Keys: 2) - schemas.AspectRule (Total Keys: 5) --- .../documents/servicenetworking.v1.json | 28 ++++++++++++++++++- .../documents/servicenetworking.v1beta.json | 28 ++++++++++++++++++- 2 files changed, 54 insertions(+), 2 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/servicenetworking.v1.json b/googleapiclient/discovery_cache/documents/servicenetworking.v1.json index 753da80eaa7..b1aae6b40c5 100644 --- a/googleapiclient/discovery_cache/documents/servicenetworking.v1.json +++ b/googleapiclient/discovery_cache/documents/servicenetworking.v1.json @@ -1034,7 +1034,7 @@ } } }, -"revision": "20260119", +"revision": "20260216", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1304,6 +1304,13 @@ "description": "The type of this aspect configuration.", "type": "string" }, +"rules": { +"description": "Optional. Rules of the Configuration.", +"items": { +"$ref": "AspectRule" +}, +"type": "array" +}, "spec": { "additionalProperties": { "description": "Properties of the object.", @@ -1315,6 +1322,25 @@ }, "type": "object" }, +"AspectRule": { +"description": "Rule-based configuration for an aspect.", +"id": "AspectRule", +"properties": { +"config": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`.", +"type": "object" +}, +"selector": { +"description": "Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details.", +"type": "string" +} +}, +"type": "object" +}, "AuthProvider": { "description": "Configuration for an authentication provider, including support for [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).", "id": "AuthProvider", diff --git a/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json b/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json index e899d58147b..f4749919dcc 100644 --- a/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json +++ b/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json @@ -307,7 +307,7 @@ } } }, -"revision": "20260119", +"revision": "20260216", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -466,6 +466,13 @@ "description": "The type of this aspect configuration.", "type": "string" }, +"rules": { +"description": "Optional. Rules of the Configuration.", +"items": { +"$ref": "AspectRule" +}, +"type": "array" +}, "spec": { "additionalProperties": { "description": "Properties of the object.", @@ -477,6 +484,25 @@ }, "type": "object" }, +"AspectRule": { +"description": "Rule-based configuration for an aspect.", +"id": "AspectRule", +"properties": { +"config": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`.", +"type": "object" +}, +"selector": { +"description": "Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details.", +"type": "string" +} +}, +"type": "object" +}, "AuthProvider": { "description": "Configuration for an authentication provider, including support for [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).", "id": "AuthProvider", From 7dfc82f1d96826e25065a44d81c9378e753b6bfa Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:58 +0000 Subject: [PATCH 28/29] feat(threatintelligence): update the api #### threatintelligence:v1beta The following keys were deleted: - resources.projects.resources.alerts.methods.refreshUriStatus (Total Keys: 12) - resources.projects.resources.alerts.methods.reportAlertUri (Total Keys: 12) - schemas.AffectedSoftware (Total Keys: 4) - schemas.Alert.properties.assets (Total Keys: 3) - schemas.AlertDetail.properties.suspiciousDomain.$ref (Total Keys: 1) - schemas.AlertDetail.properties.targetTechnology.$ref (Total Keys: 1) - schemas.AssetDiscoveryConfig (Total Keys: 14) - schemas.AssetDiscoverySeed (Total Keys: 4) - schemas.Association (Total Keys: 4) - schemas.CompromisedCredentialsFindingDetail (Total Keys: 21) - schemas.ConfigurationDetail.properties.assetDiscovery.$ref (Total Keys: 1) - schemas.ConfigurationDetail.properties.domainMonitoring.$ref (Total Keys: 1) - schemas.ConfigurationDetail.properties.initialAccessBroker.$ref (Total Keys: 1) - schemas.ConfigurationDetail.properties.technologyWatchlist.$ref (Total Keys: 1) - schemas.DomainMonitoringConfig (Total Keys: 4) - schemas.DomainMonitoringDomain (Total Keys: 3) - schemas.EntityProfile (Total Keys: 16) - schemas.Finding.properties.asset.type (Total Keys: 1) - schemas.Finding.properties.issue.type (Total Keys: 1) - schemas.FindingDetail.properties.compromisedCredentials.$ref (Total Keys: 1) - schemas.FindingDetail.properties.inbandVulnerability.$ref (Total Keys: 1) - schemas.FindingDetail.properties.misconfiguration.$ref (Total Keys: 1) - schemas.FindingDetail.properties.suspiciousDomain.$ref (Total Keys: 1) - schemas.FindingDetail.properties.targetTechnology.$ref (Total Keys: 1) - schemas.InbandVulnerability (Total Keys: 23) - schemas.InitialAccessBrokerConfig (Total Keys: 3) - schemas.MisconfigurationFindingDetail (Total Keys: 3) - schemas.MisconfigurationMetadata (Total Keys: 8) - schemas.MisconfigurationReference (Total Keys: 4) - schemas.RefreshAlertUriStatusRequest (Total Keys: 2) - schemas.RefreshAlertUriStatusResponse (Total Keys: 4) - schemas.ReportAlertUriRequest (Total Keys: 2) - schemas.ReportAlertUriResponse (Total Keys: 4) - schemas.SuspiciousDomainAlertDetail (Total Keys: 10) - schemas.SuspiciousDomainDnsDetails (Total Keys: 6) - schemas.SuspiciousDomainDnsRecord (Total Keys: 7) - schemas.SuspiciousDomainFindingDetail (Total Keys: 9) - schemas.SuspiciousDomainGtiDetails (Total Keys: 7) - schemas.SuspiciousDomainWhoIsDetails (Total Keys: 5) - schemas.TargetTechnologyAlertDetail (Total Keys: 3) - schemas.TargetTechnologyFindingDetail (Total Keys: 3) - schemas.TechnologyWatchListAlertThreshold (Total Keys: 9) - schemas.TechnologyWatchListConfig (Total Keys: 5) - schemas.VulnerabilityMatch (Total Keys: 12) --- ...atintelligence_v1beta.projects.alerts.html | 573 --------- ...igence_v1beta.projects.configurations.html | 192 +-- ...eta.projects.configurations.revisions.html | 66 +- ...intelligence_v1beta.projects.findings.html | 327 +---- .../documents/threatintelligence.v1beta.json | 1053 +---------------- 5 files changed, 30 insertions(+), 2181 deletions(-) diff --git a/docs/dyn/threatintelligence_v1beta.projects.alerts.html b/docs/dyn/threatintelligence_v1beta.projects.alerts.html index 5f547503f89..238a09b9fd2 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.alerts.html +++ b/docs/dyn/threatintelligence_v1beta.projects.alerts.html @@ -112,12 +112,6 @@

Instance Methods

read(name, body=None, x__xgafv=None)

Marks an alert as read - READ.

-

- refreshUriStatus(name, body=None, x__xgafv=None)

-

Return the status of a URI submitted to Google WebRisk.

-

- reportAlertUri(name, body=None, x__xgafv=None)

-

Report the URI associated with an alert to Google WebRisk.

resolve(name, body=None, x__xgafv=None)

Marks an alert to closed state - RESOLVED.

@@ -150,9 +144,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -182,50 +173,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -295,9 +242,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -327,50 +271,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -468,9 +368,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -500,50 +397,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -607,9 +460,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -639,50 +489,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -740,9 +546,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -772,50 +575,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -879,9 +638,6 @@

Method Details

"alerts": [ # List of alerts. { # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -911,50 +667,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -1035,9 +747,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -1067,50 +776,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -1174,9 +839,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -1206,50 +868,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -1291,56 +909,6 @@

Method Details

}
-
- refreshUriStatus(name, body=None, x__xgafv=None) -
Return the status of a URI submitted to Google WebRisk.
-
-Args:
-  name: string, Required. Name of alert to refresh status from WebRisk (required)
-  body: object, The request body.
-    The object takes the form of:
-
-{ # Request message for FetchAlertUriStatus.
-}
-
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # Response message for FetchAlertUriStatus.
-  "state": "A String", # Output only. Status of the alert in WebRisk.
-}
-
- -
- reportAlertUri(name, body=None, x__xgafv=None) -
Report the URI associated with an alert to Google WebRisk.
-
-Args:
-  name: string, Required. Name of alert to submit to WebRisk. (required)
-  body: object, The request body.
-    The object takes the form of:
-
-{ # Request message for ReportAlertUri.
-}
-
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # Response message for ReportAlertUri.
-  "state": "A String", # Output only. Status of the alert in WebRisk.
-}
-
-
resolve(name, body=None, x__xgafv=None)
Marks an alert to closed state - RESOLVED.
@@ -1363,9 +931,6 @@ 

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -1395,50 +960,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -1502,9 +1023,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -1534,50 +1052,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} @@ -1641,9 +1115,6 @@

Method Details

{ # Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet. "aiSummary": "A String", # Optional. AI summary of the finding. - "assets": [ # Output only. Assets that are impacted by this alert. - "A String", - ], "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the alert. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -1673,50 +1144,6 @@

Method Details

], "severity": "A String", # Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL") }, - "suspiciousDomain": { # The alert detail for a suspicious domain finding. # Domain Monitoring alert detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "webRiskOperation": "A String", # Output only. Name of Web Risk submission operation. - "webRiskState": "A String", # Output only. Status of the Web Risk submission. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist alert. # Technology Watchlist alert detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Output only. A short title for the alert. "duplicateOf": "A String", # Output only. alert name of the alert this alert is a duplicate of. Format: projects/{project}/alerts/{alert} diff --git a/docs/dyn/threatintelligence_v1beta.projects.configurations.html b/docs/dyn/threatintelligence_v1beta.projects.configurations.html index f0a240ecdd0..ddbf66d83e2 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.configurations.html +++ b/docs/dyn/threatintelligence_v1beta.projects.configurations.html @@ -123,24 +123,6 @@

Method Details

}, "description": "A String", # Optional. A description of the configuration. "detail": { # Wrapper class that contains the union struct for all the various configuration detail specific classes. # Required. Domain specific details for the configuration. - "assetDiscovery": { # Customer defined Configuration for asset discovery. # Asset Discovery detail config. - "lastScanCompleteTime": "A String", # Output only. Timestamp of the last scan completed. This field is set by the system and cannot be modified by the user. - "lastScanStartTime": "A String", # Output only. Timestamp of the last scan started - used for scheduling the next scan. This field is set by the system and cannot be modified by the user. - "scanFrequency": "A String", # Required. Frequency at which the scheduled discovery scan should be run. If not specified, the default frequency is DAILY. - "scopeExclusionAssets": [ # Optional. Seed assets that are out of scope for the scheduled discovery scan. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "seedAssets": [ # Required. Seed assets for the scheduled discovery scan. At least one seed asset is required. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "workflow": "A String", # Required. Workflow to be used for the scheduled discovery scan. If not specified, the default workflow is EXTERNAL_DISCOVERY. - }, "customerProfile": { # CustomerProfileConfig is the configuration for the customer profile. # Customer Profile detail config. "citations": [ # Optional. Citations for the organization profile. { # Citation information for the customer profile. @@ -300,53 +282,9 @@

Method Details

], }, "detailType": "A String", # Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - "domainMonitoring": { # Any account-level configuration options will go here. # Domain Monitoring detail config. - "domains": [ # The domains to use as "seeds" for Suspicious Domain Monitoring. - { # A Domain Monitoring "domain" - "domain": "A String", # The domain name to match against. - }, - ], - }, - "initialAccessBroker": { # InitialAccessBrokerConfig is specific to Initial Access Broker (IAB) matching scenarios. # Initial Access Broker (IAB) detail config. - "entityProfile": { # EntityProfile represents the structured profile of a customer entity, containing key identifiers and descriptive attributes optimized for contextual matching against threat intelligence, particularly Initial Access Broker (IAB) offerings. # Represents the comprehensive profile of the customer entity used for matching. - "countries": [ # Optional. List of specific countries of operation. Purpose: Essential for matching geographically targeted threats (e.g., actor specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., "US", "GB", "JP", "DE"). - "A String", - ], - "domains": [ # Required. List of primary internet domain names associated with the entity. Purpose: Crucial for explicit matching against domains mentioned in threat intel and can inform semantic matching. Must contain at least one domain. Example: ["acme.com", "acme.co.uk"] - "A String", - ], - "industries": [ # Optional. List of primary industry sectors the entity operates within. Purpose: Crucial for matching industry-specific threats and understanding attacker motivation. Use standardized GTI Industry Classification values. Example: ["Technology", "Financial Services", "Healthcare"] - "A String", - ], - "name": "A String", # Required. Canonical name of the entity (e.g., the legal company name). Purpose: Primary identifier for the customer. - "operationalAreas": [ # Optional. Specific geographic areas of *significant* operational concentration or strategic importance below the country level, if clearly identifiable and relevant. Purpose: Useful for highly localized threats, less commonly populated than `countries`. Example: ["Silicon Valley", "Frankfurt am Main Metropolitan Region"] - "A String", - ], - "profileSummary": "A String", # Required. A concise, machine-generated (e.g., LLM) or human-curated summary of the entity. Purpose: Captures the semantic essence for embedding generation and similarity matching. Should synthesize key aspects like core business, scale, and market. Example: "Acme Corporation is a large, US-based multinational conglomerate operating..." - "regions": [ # Optional. List of primary geopolitical regions where the entity has significant operations. Purpose: Filters geographically relevant threats. Use standardized names or codes where possible (e.g., "North America", "EMEA", "APAC", UN M49 codes). - "A String", - ], - "subIndustries": [ # Optional. List of more granular sub-industries, if applicable and known. Purpose: Provides finer-grained context for more specific threat matching. Should align with GTI classifications if possible. Example: ["Semiconductors", "Cloud Computing Services", "Investment Banking"] - "A String", - ], - }, - }, - "technologyWatchlist": { # TechnologyWatchListConfig is the configuration for the technology watchlist. # Technology Watchlist detail config. - "alertThreshold": { # TechnologyWatchListAlertThreshold contains the thresholds for alerting. # Optional. Alert thresholds to effectively reduce noise. - "cvssScoreMinimum": 3.14, # Optional. The minimum cvss V3 score for the alert. Ex: 7.0. Valid range is [0.0, 10.0]. - "epssScoreMinimum": 3.14, # Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0]. - "exploitationStates": [ # Optional. The exploitation states of the alert. - "A String", - ], - "priorityMinimum": "A String", # Optional. The minimum priority for the alert. - }, - "technologies": [ # Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:* - "A String", - ], - }, }, "displayName": "A String", # Output only. Human readable name for the configuration. - "name": "A String", # Identifier. Server generated name for the configuration. format is vaults/{vault}/configurations/{configuration} + "name": "A String", # Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration} "provider": "A String", # Required. Name of the service that provides the configuration. "state": "A String", # Optional. State of the configuration. "version": "A String", # Optional. A user-manipulatable version. Does not adhere to a specific format @@ -382,24 +320,6 @@

Method Details

}, "description": "A String", # Optional. A description of the configuration. "detail": { # Wrapper class that contains the union struct for all the various configuration detail specific classes. # Required. Domain specific details for the configuration. - "assetDiscovery": { # Customer defined Configuration for asset discovery. # Asset Discovery detail config. - "lastScanCompleteTime": "A String", # Output only. Timestamp of the last scan completed. This field is set by the system and cannot be modified by the user. - "lastScanStartTime": "A String", # Output only. Timestamp of the last scan started - used for scheduling the next scan. This field is set by the system and cannot be modified by the user. - "scanFrequency": "A String", # Required. Frequency at which the scheduled discovery scan should be run. If not specified, the default frequency is DAILY. - "scopeExclusionAssets": [ # Optional. Seed assets that are out of scope for the scheduled discovery scan. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "seedAssets": [ # Required. Seed assets for the scheduled discovery scan. At least one seed asset is required. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "workflow": "A String", # Required. Workflow to be used for the scheduled discovery scan. If not specified, the default workflow is EXTERNAL_DISCOVERY. - }, "customerProfile": { # CustomerProfileConfig is the configuration for the customer profile. # Customer Profile detail config. "citations": [ # Optional. Citations for the organization profile. { # Citation information for the customer profile. @@ -559,53 +479,9 @@

Method Details

], }, "detailType": "A String", # Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - "domainMonitoring": { # Any account-level configuration options will go here. # Domain Monitoring detail config. - "domains": [ # The domains to use as "seeds" for Suspicious Domain Monitoring. - { # A Domain Monitoring "domain" - "domain": "A String", # The domain name to match against. - }, - ], - }, - "initialAccessBroker": { # InitialAccessBrokerConfig is specific to Initial Access Broker (IAB) matching scenarios. # Initial Access Broker (IAB) detail config. - "entityProfile": { # EntityProfile represents the structured profile of a customer entity, containing key identifiers and descriptive attributes optimized for contextual matching against threat intelligence, particularly Initial Access Broker (IAB) offerings. # Represents the comprehensive profile of the customer entity used for matching. - "countries": [ # Optional. List of specific countries of operation. Purpose: Essential for matching geographically targeted threats (e.g., actor specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., "US", "GB", "JP", "DE"). - "A String", - ], - "domains": [ # Required. List of primary internet domain names associated with the entity. Purpose: Crucial for explicit matching against domains mentioned in threat intel and can inform semantic matching. Must contain at least one domain. Example: ["acme.com", "acme.co.uk"] - "A String", - ], - "industries": [ # Optional. List of primary industry sectors the entity operates within. Purpose: Crucial for matching industry-specific threats and understanding attacker motivation. Use standardized GTI Industry Classification values. Example: ["Technology", "Financial Services", "Healthcare"] - "A String", - ], - "name": "A String", # Required. Canonical name of the entity (e.g., the legal company name). Purpose: Primary identifier for the customer. - "operationalAreas": [ # Optional. Specific geographic areas of *significant* operational concentration or strategic importance below the country level, if clearly identifiable and relevant. Purpose: Useful for highly localized threats, less commonly populated than `countries`. Example: ["Silicon Valley", "Frankfurt am Main Metropolitan Region"] - "A String", - ], - "profileSummary": "A String", # Required. A concise, machine-generated (e.g., LLM) or human-curated summary of the entity. Purpose: Captures the semantic essence for embedding generation and similarity matching. Should synthesize key aspects like core business, scale, and market. Example: "Acme Corporation is a large, US-based multinational conglomerate operating..." - "regions": [ # Optional. List of primary geopolitical regions where the entity has significant operations. Purpose: Filters geographically relevant threats. Use standardized names or codes where possible (e.g., "North America", "EMEA", "APAC", UN M49 codes). - "A String", - ], - "subIndustries": [ # Optional. List of more granular sub-industries, if applicable and known. Purpose: Provides finer-grained context for more specific threat matching. Should align with GTI classifications if possible. Example: ["Semiconductors", "Cloud Computing Services", "Investment Banking"] - "A String", - ], - }, - }, - "technologyWatchlist": { # TechnologyWatchListConfig is the configuration for the technology watchlist. # Technology Watchlist detail config. - "alertThreshold": { # TechnologyWatchListAlertThreshold contains the thresholds for alerting. # Optional. Alert thresholds to effectively reduce noise. - "cvssScoreMinimum": 3.14, # Optional. The minimum cvss V3 score for the alert. Ex: 7.0. Valid range is [0.0, 10.0]. - "epssScoreMinimum": 3.14, # Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0]. - "exploitationStates": [ # Optional. The exploitation states of the alert. - "A String", - ], - "priorityMinimum": "A String", # Optional. The minimum priority for the alert. - }, - "technologies": [ # Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:* - "A String", - ], - }, }, "displayName": "A String", # Output only. Human readable name for the configuration. - "name": "A String", # Identifier. Server generated name for the configuration. format is vaults/{vault}/configurations/{configuration} + "name": "A String", # Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration} "provider": "A String", # Required. Name of the service that provides the configuration. "state": "A String", # Optional. State of the configuration. "version": "A String", # Optional. A user-manipulatable version. Does not adhere to a specific format @@ -647,24 +523,6 @@

Method Details

}, "description": "A String", # Optional. A description of the configuration. "detail": { # Wrapper class that contains the union struct for all the various configuration detail specific classes. # Required. Domain specific details for the configuration. - "assetDiscovery": { # Customer defined Configuration for asset discovery. # Asset Discovery detail config. - "lastScanCompleteTime": "A String", # Output only. Timestamp of the last scan completed. This field is set by the system and cannot be modified by the user. - "lastScanStartTime": "A String", # Output only. Timestamp of the last scan started - used for scheduling the next scan. This field is set by the system and cannot be modified by the user. - "scanFrequency": "A String", # Required. Frequency at which the scheduled discovery scan should be run. If not specified, the default frequency is DAILY. - "scopeExclusionAssets": [ # Optional. Seed assets that are out of scope for the scheduled discovery scan. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "seedAssets": [ # Required. Seed assets for the scheduled discovery scan. At least one seed asset is required. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "workflow": "A String", # Required. Workflow to be used for the scheduled discovery scan. If not specified, the default workflow is EXTERNAL_DISCOVERY. - }, "customerProfile": { # CustomerProfileConfig is the configuration for the customer profile. # Customer Profile detail config. "citations": [ # Optional. Citations for the organization profile. { # Citation information for the customer profile. @@ -824,53 +682,9 @@

Method Details

], }, "detailType": "A String", # Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - "domainMonitoring": { # Any account-level configuration options will go here. # Domain Monitoring detail config. - "domains": [ # The domains to use as "seeds" for Suspicious Domain Monitoring. - { # A Domain Monitoring "domain" - "domain": "A String", # The domain name to match against. - }, - ], - }, - "initialAccessBroker": { # InitialAccessBrokerConfig is specific to Initial Access Broker (IAB) matching scenarios. # Initial Access Broker (IAB) detail config. - "entityProfile": { # EntityProfile represents the structured profile of a customer entity, containing key identifiers and descriptive attributes optimized for contextual matching against threat intelligence, particularly Initial Access Broker (IAB) offerings. # Represents the comprehensive profile of the customer entity used for matching. - "countries": [ # Optional. List of specific countries of operation. Purpose: Essential for matching geographically targeted threats (e.g., actor specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., "US", "GB", "JP", "DE"). - "A String", - ], - "domains": [ # Required. List of primary internet domain names associated with the entity. Purpose: Crucial for explicit matching against domains mentioned in threat intel and can inform semantic matching. Must contain at least one domain. Example: ["acme.com", "acme.co.uk"] - "A String", - ], - "industries": [ # Optional. List of primary industry sectors the entity operates within. Purpose: Crucial for matching industry-specific threats and understanding attacker motivation. Use standardized GTI Industry Classification values. Example: ["Technology", "Financial Services", "Healthcare"] - "A String", - ], - "name": "A String", # Required. Canonical name of the entity (e.g., the legal company name). Purpose: Primary identifier for the customer. - "operationalAreas": [ # Optional. Specific geographic areas of *significant* operational concentration or strategic importance below the country level, if clearly identifiable and relevant. Purpose: Useful for highly localized threats, less commonly populated than `countries`. Example: ["Silicon Valley", "Frankfurt am Main Metropolitan Region"] - "A String", - ], - "profileSummary": "A String", # Required. A concise, machine-generated (e.g., LLM) or human-curated summary of the entity. Purpose: Captures the semantic essence for embedding generation and similarity matching. Should synthesize key aspects like core business, scale, and market. Example: "Acme Corporation is a large, US-based multinational conglomerate operating..." - "regions": [ # Optional. List of primary geopolitical regions where the entity has significant operations. Purpose: Filters geographically relevant threats. Use standardized names or codes where possible (e.g., "North America", "EMEA", "APAC", UN M49 codes). - "A String", - ], - "subIndustries": [ # Optional. List of more granular sub-industries, if applicable and known. Purpose: Provides finer-grained context for more specific threat matching. Should align with GTI classifications if possible. Example: ["Semiconductors", "Cloud Computing Services", "Investment Banking"] - "A String", - ], - }, - }, - "technologyWatchlist": { # TechnologyWatchListConfig is the configuration for the technology watchlist. # Technology Watchlist detail config. - "alertThreshold": { # TechnologyWatchListAlertThreshold contains the thresholds for alerting. # Optional. Alert thresholds to effectively reduce noise. - "cvssScoreMinimum": 3.14, # Optional. The minimum cvss V3 score for the alert. Ex: 7.0. Valid range is [0.0, 10.0]. - "epssScoreMinimum": 3.14, # Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0]. - "exploitationStates": [ # Optional. The exploitation states of the alert. - "A String", - ], - "priorityMinimum": "A String", # Optional. The minimum priority for the alert. - }, - "technologies": [ # Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:* - "A String", - ], - }, }, "displayName": "A String", # Output only. Human readable name for the configuration. - "name": "A String", # Identifier. Server generated name for the configuration. format is vaults/{vault}/configurations/{configuration} + "name": "A String", # Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration} "provider": "A String", # Required. Name of the service that provides the configuration. "state": "A String", # Optional. State of the configuration. "version": "A String", # Optional. A user-manipulatable version. Does not adhere to a specific format diff --git a/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html b/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html index 18cd165bbbf..c90a6fe47ef 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html +++ b/docs/dyn/threatintelligence_v1beta.projects.configurations.revisions.html @@ -112,7 +112,7 @@

Method Details

"revisions": [ # The Configuration Revisions associated with the specified Configuration { # A ConfigurationRevision is a snapshot of a Configuration at a point in time. It is immutable. "createTime": "A String", # Output only. The time the Revision was created - "name": "A String", # Identifier. The name of the ConfigurationRevision Format: vaults//configurations//revisions/ OR projects//configurations//revisions/ + "name": "A String", # Identifier. The name of the ConfigurationRevision Format: projects//configurations//revisions/ "snapshot": { # A configuration represents a behavior an engine should follow when producing new findings. # The snapshot of the configuration "audit": { # Tracks basic CRUD facts. # Output only. Audit information for the configuration. "createTime": "A String", # Output only. Time of creation. @@ -122,24 +122,6 @@

Method Details

}, "description": "A String", # Optional. A description of the configuration. "detail": { # Wrapper class that contains the union struct for all the various configuration detail specific classes. # Required. Domain specific details for the configuration. - "assetDiscovery": { # Customer defined Configuration for asset discovery. # Asset Discovery detail config. - "lastScanCompleteTime": "A String", # Output only. Timestamp of the last scan completed. This field is set by the system and cannot be modified by the user. - "lastScanStartTime": "A String", # Output only. Timestamp of the last scan started - used for scheduling the next scan. This field is set by the system and cannot be modified by the user. - "scanFrequency": "A String", # Required. Frequency at which the scheduled discovery scan should be run. If not specified, the default frequency is DAILY. - "scopeExclusionAssets": [ # Optional. Seed assets that are out of scope for the scheduled discovery scan. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "seedAssets": [ # Required. Seed assets for the scheduled discovery scan. At least one seed asset is required. - { # Seed assets for asset discovery. - "seedType": "A String", # Required. Type of the seed asset. - "seedValue": "A String", # Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc. - }, - ], - "workflow": "A String", # Required. Workflow to be used for the scheduled discovery scan. If not specified, the default workflow is EXTERNAL_DISCOVERY. - }, "customerProfile": { # CustomerProfileConfig is the configuration for the customer profile. # Customer Profile detail config. "citations": [ # Optional. Citations for the organization profile. { # Citation information for the customer profile. @@ -299,53 +281,9 @@

Method Details

], }, "detailType": "A String", # Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - "domainMonitoring": { # Any account-level configuration options will go here. # Domain Monitoring detail config. - "domains": [ # The domains to use as "seeds" for Suspicious Domain Monitoring. - { # A Domain Monitoring "domain" - "domain": "A String", # The domain name to match against. - }, - ], - }, - "initialAccessBroker": { # InitialAccessBrokerConfig is specific to Initial Access Broker (IAB) matching scenarios. # Initial Access Broker (IAB) detail config. - "entityProfile": { # EntityProfile represents the structured profile of a customer entity, containing key identifiers and descriptive attributes optimized for contextual matching against threat intelligence, particularly Initial Access Broker (IAB) offerings. # Represents the comprehensive profile of the customer entity used for matching. - "countries": [ # Optional. List of specific countries of operation. Purpose: Essential for matching geographically targeted threats (e.g., actor specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., "US", "GB", "JP", "DE"). - "A String", - ], - "domains": [ # Required. List of primary internet domain names associated with the entity. Purpose: Crucial for explicit matching against domains mentioned in threat intel and can inform semantic matching. Must contain at least one domain. Example: ["acme.com", "acme.co.uk"] - "A String", - ], - "industries": [ # Optional. List of primary industry sectors the entity operates within. Purpose: Crucial for matching industry-specific threats and understanding attacker motivation. Use standardized GTI Industry Classification values. Example: ["Technology", "Financial Services", "Healthcare"] - "A String", - ], - "name": "A String", # Required. Canonical name of the entity (e.g., the legal company name). Purpose: Primary identifier for the customer. - "operationalAreas": [ # Optional. Specific geographic areas of *significant* operational concentration or strategic importance below the country level, if clearly identifiable and relevant. Purpose: Useful for highly localized threats, less commonly populated than `countries`. Example: ["Silicon Valley", "Frankfurt am Main Metropolitan Region"] - "A String", - ], - "profileSummary": "A String", # Required. A concise, machine-generated (e.g., LLM) or human-curated summary of the entity. Purpose: Captures the semantic essence for embedding generation and similarity matching. Should synthesize key aspects like core business, scale, and market. Example: "Acme Corporation is a large, US-based multinational conglomerate operating..." - "regions": [ # Optional. List of primary geopolitical regions where the entity has significant operations. Purpose: Filters geographically relevant threats. Use standardized names or codes where possible (e.g., "North America", "EMEA", "APAC", UN M49 codes). - "A String", - ], - "subIndustries": [ # Optional. List of more granular sub-industries, if applicable and known. Purpose: Provides finer-grained context for more specific threat matching. Should align with GTI classifications if possible. Example: ["Semiconductors", "Cloud Computing Services", "Investment Banking"] - "A String", - ], - }, - }, - "technologyWatchlist": { # TechnologyWatchListConfig is the configuration for the technology watchlist. # Technology Watchlist detail config. - "alertThreshold": { # TechnologyWatchListAlertThreshold contains the thresholds for alerting. # Optional. Alert thresholds to effectively reduce noise. - "cvssScoreMinimum": 3.14, # Optional. The minimum cvss V3 score for the alert. Ex: 7.0. Valid range is [0.0, 10.0]. - "epssScoreMinimum": 3.14, # Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0]. - "exploitationStates": [ # Optional. The exploitation states of the alert. - "A String", - ], - "priorityMinimum": "A String", # Optional. The minimum priority for the alert. - }, - "technologies": [ # Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:* - "A String", - ], - }, }, "displayName": "A String", # Output only. Human readable name for the configuration. - "name": "A String", # Identifier. Server generated name for the configuration. format is vaults/{vault}/configurations/{configuration} + "name": "A String", # Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration} "provider": "A String", # Required. Name of the service that provides the configuration. "state": "A String", # Optional. State of the configuration. "version": "A String", # Optional. A user-manipulatable version. Does not adhere to a specific format diff --git a/docs/dyn/threatintelligence_v1beta.projects.findings.html b/docs/dyn/threatintelligence_v1beta.projects.findings.html index 75bc7a9b42a..5c69cfa7915 100644 --- a/docs/dyn/threatintelligence_v1beta.projects.findings.html +++ b/docs/dyn/threatintelligence_v1beta.projects.findings.html @@ -115,7 +115,6 @@

Method Details

{ # A ‘stateless’ and a point in time event that a check produced a result of interest. "aiSummary": "A String", # Optional. AI summary of the finding. "alert": "A String", # Optional. Name of the alert that this finding is bound to. - "asset": "A String", # Optional. Optional - asset name if known. Format: vaults/{vault}/assets/{asset} "audit": { # Tracks basic CRUD facts. # Output only. Audit data about the finding. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -126,58 +125,12 @@

Method Details

"A String", ], "detail": { # Wrapper class that contains the union struct for all the various findings detail specific classes. # Required. Holder of the domain specific details of the finding. - "compromisedCredentials": { # Sample compromised credential detail. # Compromised Credentials detail type. - "author": "A String", # Optional. Reference to the author this detail was extracted from. This is deprecated and will be removed. - "credentialService": "A String", # Optional. Claimed site the credential is intended for. - "darkWebDoc": "A String", # Optional. Reference to the dark web document. This is deprecated and will be removed. - "externalReferenceUri": "A String", # Optional. This will contain a link to the external reference for this credential. If set, this is a link back to the DTM product to allow customers to get additional context about this finding. - "fileDump": "A String", # Optional. If the source of the credential was from a file dump this will contain the name of the file the credential was found in. This can be used by customers for context on where the credential was found and to try to find other references to the file in the wild. - "fileDumpHashes": [ # Optional. A list of hashes of the file dump. These will be prefixed with the algorithm. Example: "sha256:" - "A String", - ], - "fileDumpSizeBytes": "A String", # Optional. If file_dump is set this will contain the size of the dump file in bytes. File dumps can be very large. - "forum": "A String", # Optional. Reference to the forum this detail was extracted from. This is deprecated and will be removed. - "malwareFamily": "A String", # Optional. This will indicate the malware family that leaked this credential, if known. - "postedTime": "A String", # Optional. This indicates our best guess as to when the credential was leaked to the particular venue that triggered this finding. This is not necessarily the time the credential was actually leaked and it may not always be be accurate. - "sourceUri": "A String", # Optional. If the source of a credential is publicly addressable this will contain a uri to the where the credential was found. - "userKey": "A String", # Required. This field will always be set and will be used to identify the user named in the credential leak. In cases where customers are authorized to see the actual user key this will be set to the actual user key. In cases where the customer is not authorized to see the actual user key this will be set to a hash of the user key. The hashed value is an intentionally opaque value that is not intended to be used for any other purpose than to uniquely identify the user in the context of this specific customer, service domain, and user name. Example: "user@example.com" or "redacted:". - "userSecretEvidence": "A String", # Optional. Claimed evidence of the password/secret. This will always be hashed. In the event where the plaintext password is known it will be set to "redacted:" where the same hash will be presented when the same password is found for the same organization for the same service. Redaction is done by hashing the password with a salt that is unique to the customer organization and service. In the event where the plaintext password is not known it will be set to ":" where the algorithm is the hash algorithm used and the hash is the hash of the password using that algorithm. In the event we don't know the exact algorithm used we will set it to "hashed:". - }, "dataLeak": { # A detail object for a Data Leak finding. # Data Leak finding detail type. "documentId": "A String", # Required. The unique identifier of the document that triggered the Data Leak finding. This ID can be used to retrieve the content of the document for further analysis. "matchScore": 3.14, # Required. Reference to the match score of the Data Leak finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. "severity": "A String", # Required. The severity of the Data Leak finding. This indicates the potential impact of the threat. }, "detailType": "A String", # Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - "inbandVulnerability": { # This is a temporary detail type that will be used to support vulnerabilities until the engines start using the full vulnerability objects. The "Inband" refers to the fact that all vulnerability details are included with every finding. # Inband vulnerability detail type. - "formattedProofDetails": "A String", # Optional. A short description of the proof of the vulnerability. - "requestUri": "A String", # Optional. The URI that lead to this detection, if appropriate. - "vulnerability": { # Fleshed out vulnerability object that includes enough details to fill out a vulnerability specific view for an issue. # Required. Vulnerability metadata. - "affectedSoftware": [ # Optional. The software that is affected by the vulnerability. - { # The software that is affected by the vulnerability. - "product": "A String", # Optional. The product of the software. - "vendor": "A String", # Optional. The vendor of the software. - }, - ], - "authors": [ # Optional. The authors of the vulnerability detection. - "A String", - ], - "cveId": "A String", # Required. The CVE ID of the vulnerability. - "cvssV31Score": 3.14, # Required. The CVSS V3.1 score (Base score)for the vulnerability. ( ) - "cvssV31ScoreTemporal": 3.14, # Optional. Temporal CVSS V3.1 score for the vulnerability. - "description": "A String", # Optional. The human readable description. This can be basic HTML formatted text. - "disclosureTime": "A String", # Optional. The date the vulnerability was first disclosed. - "exploitationState": "A String", # Optional. Exploitation state of the vulnerability, for example "Available". - "externalVulnerabilityId": "A String", # Required. The external ID of the vulnerability. - "isExploitedWild": True or False, # Optional. Whether this is exploited in the wild. - "referenceUrls": [ # Optional. Reference URLs to the vulnerability. - "A String", - ], - "remediation": "A String", # Optional. The human readable remediation recommendation. This can be basic HTML formatted text. - "riskRating": "A String", # Optional. Risk rating for the vulnerability, for example "High". - "title": "A String", # Optional. Human readable name for the vulnerability. - }, - }, "initialAccessBroker": { # A detail object for an Initial Access Broker (IAB) finding. # Initial Access Broker finding detail type. "documentId": "A String", # Required. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis. "matchScore": 3.14, # Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. @@ -188,69 +141,9 @@

Method Details

"matchScore": 3.14, # Required. Reference to the match score of the InsiderThreat finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. "severity": "A String", # Required. The severity of the InsiderThreat finding. This indicates the potential impact of the threat. }, - "misconfiguration": { # Misconfiguration finding detail. # Misconfiguration finding detail type. - "misconfigurationMetadata": { # Misconfiguration metadata. # Required. The misconfiguration metadata. - "description": "A String", # Optional. Description of the misconfiguration. - "displayName": "A String", # Optional. A user-friendly name for the misconfiguration. - "misconfigurationId": "A String", # Required. The identifier for the misconfiguration. This is an internal name generated by the finding provider. - "references": [ # Optional. References to external resources that provide more information about the misconfiguration. - { # A reference to an external resource that provides more information about a misconfiguration. - "type": "A String", # Required. The type of the reference (e.g., "description", "remediation"). - "uri": "A String", # Required. The URI of the reference. - }, - ], - "remediation": "A String", # Optional. Recommended remediation steps for the misconfiguration. - "vulnerableUri": "A String", # Optional. The endpoint which was found to have the vulnerability. - }, - }, - "suspiciousDomain": { # A detailed object for a suspicious Domain finding. # Domain Monitoring finding detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "matchScore": 3.14, # Required. Reference to the match score of the finding. This is a float value between 0 and 1 calculated by the matching engine. - "severity": "A String", # Required. The severity of the finding. This indicates the potential impact of the threat. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist finding. # Technology Watchlist finding detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Required. A short descriptive title for the finding <= 250 chars. EX: "Actor 'baddy' offering $1000 for credentials of 'goodguy'". - "issue": "A String", # Optional. Optional - name of the issue that this finding is bound to. Format: vaults/{vault}/issues/{issue} - "name": "A String", # Identifier. Server generated name for the finding (leave clear during creation). Format: vaults/{vault}/findings/{finding} + "name": "A String", # Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project}/findings/{finding} "provider": "A String", # Required. Logical source of this finding (name of the sub-engine). "relevanceAnalysis": { # Structured relevance analysis for a threat. # Output only. High-Precision Relevance Analysis verdict for the finding. "confidence": "A String", # The level of confidence in the given verdict. @@ -301,7 +194,6 @@

Method Details

{ # A ‘stateless’ and a point in time event that a check produced a result of interest. "aiSummary": "A String", # Optional. AI summary of the finding. "alert": "A String", # Optional. Name of the alert that this finding is bound to. - "asset": "A String", # Optional. Optional - asset name if known. Format: vaults/{vault}/assets/{asset} "audit": { # Tracks basic CRUD facts. # Output only. Audit data about the finding. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -312,58 +204,12 @@

Method Details

"A String", ], "detail": { # Wrapper class that contains the union struct for all the various findings detail specific classes. # Required. Holder of the domain specific details of the finding. - "compromisedCredentials": { # Sample compromised credential detail. # Compromised Credentials detail type. - "author": "A String", # Optional. Reference to the author this detail was extracted from. This is deprecated and will be removed. - "credentialService": "A String", # Optional. Claimed site the credential is intended for. - "darkWebDoc": "A String", # Optional. Reference to the dark web document. This is deprecated and will be removed. - "externalReferenceUri": "A String", # Optional. This will contain a link to the external reference for this credential. If set, this is a link back to the DTM product to allow customers to get additional context about this finding. - "fileDump": "A String", # Optional. If the source of the credential was from a file dump this will contain the name of the file the credential was found in. This can be used by customers for context on where the credential was found and to try to find other references to the file in the wild. - "fileDumpHashes": [ # Optional. A list of hashes of the file dump. These will be prefixed with the algorithm. Example: "sha256:" - "A String", - ], - "fileDumpSizeBytes": "A String", # Optional. If file_dump is set this will contain the size of the dump file in bytes. File dumps can be very large. - "forum": "A String", # Optional. Reference to the forum this detail was extracted from. This is deprecated and will be removed. - "malwareFamily": "A String", # Optional. This will indicate the malware family that leaked this credential, if known. - "postedTime": "A String", # Optional. This indicates our best guess as to when the credential was leaked to the particular venue that triggered this finding. This is not necessarily the time the credential was actually leaked and it may not always be be accurate. - "sourceUri": "A String", # Optional. If the source of a credential is publicly addressable this will contain a uri to the where the credential was found. - "userKey": "A String", # Required. This field will always be set and will be used to identify the user named in the credential leak. In cases where customers are authorized to see the actual user key this will be set to the actual user key. In cases where the customer is not authorized to see the actual user key this will be set to a hash of the user key. The hashed value is an intentionally opaque value that is not intended to be used for any other purpose than to uniquely identify the user in the context of this specific customer, service domain, and user name. Example: "user@example.com" or "redacted:". - "userSecretEvidence": "A String", # Optional. Claimed evidence of the password/secret. This will always be hashed. In the event where the plaintext password is known it will be set to "redacted:" where the same hash will be presented when the same password is found for the same organization for the same service. Redaction is done by hashing the password with a salt that is unique to the customer organization and service. In the event where the plaintext password is not known it will be set to ":" where the algorithm is the hash algorithm used and the hash is the hash of the password using that algorithm. In the event we don't know the exact algorithm used we will set it to "hashed:". - }, "dataLeak": { # A detail object for a Data Leak finding. # Data Leak finding detail type. "documentId": "A String", # Required. The unique identifier of the document that triggered the Data Leak finding. This ID can be used to retrieve the content of the document for further analysis. "matchScore": 3.14, # Required. Reference to the match score of the Data Leak finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. "severity": "A String", # Required. The severity of the Data Leak finding. This indicates the potential impact of the threat. }, "detailType": "A String", # Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - "inbandVulnerability": { # This is a temporary detail type that will be used to support vulnerabilities until the engines start using the full vulnerability objects. The "Inband" refers to the fact that all vulnerability details are included with every finding. # Inband vulnerability detail type. - "formattedProofDetails": "A String", # Optional. A short description of the proof of the vulnerability. - "requestUri": "A String", # Optional. The URI that lead to this detection, if appropriate. - "vulnerability": { # Fleshed out vulnerability object that includes enough details to fill out a vulnerability specific view for an issue. # Required. Vulnerability metadata. - "affectedSoftware": [ # Optional. The software that is affected by the vulnerability. - { # The software that is affected by the vulnerability. - "product": "A String", # Optional. The product of the software. - "vendor": "A String", # Optional. The vendor of the software. - }, - ], - "authors": [ # Optional. The authors of the vulnerability detection. - "A String", - ], - "cveId": "A String", # Required. The CVE ID of the vulnerability. - "cvssV31Score": 3.14, # Required. The CVSS V3.1 score (Base score)for the vulnerability. ( ) - "cvssV31ScoreTemporal": 3.14, # Optional. Temporal CVSS V3.1 score for the vulnerability. - "description": "A String", # Optional. The human readable description. This can be basic HTML formatted text. - "disclosureTime": "A String", # Optional. The date the vulnerability was first disclosed. - "exploitationState": "A String", # Optional. Exploitation state of the vulnerability, for example "Available". - "externalVulnerabilityId": "A String", # Required. The external ID of the vulnerability. - "isExploitedWild": True or False, # Optional. Whether this is exploited in the wild. - "referenceUrls": [ # Optional. Reference URLs to the vulnerability. - "A String", - ], - "remediation": "A String", # Optional. The human readable remediation recommendation. This can be basic HTML formatted text. - "riskRating": "A String", # Optional. Risk rating for the vulnerability, for example "High". - "title": "A String", # Optional. Human readable name for the vulnerability. - }, - }, "initialAccessBroker": { # A detail object for an Initial Access Broker (IAB) finding. # Initial Access Broker finding detail type. "documentId": "A String", # Required. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis. "matchScore": 3.14, # Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. @@ -374,69 +220,9 @@

Method Details

"matchScore": 3.14, # Required. Reference to the match score of the InsiderThreat finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. "severity": "A String", # Required. The severity of the InsiderThreat finding. This indicates the potential impact of the threat. }, - "misconfiguration": { # Misconfiguration finding detail. # Misconfiguration finding detail type. - "misconfigurationMetadata": { # Misconfiguration metadata. # Required. The misconfiguration metadata. - "description": "A String", # Optional. Description of the misconfiguration. - "displayName": "A String", # Optional. A user-friendly name for the misconfiguration. - "misconfigurationId": "A String", # Required. The identifier for the misconfiguration. This is an internal name generated by the finding provider. - "references": [ # Optional. References to external resources that provide more information about the misconfiguration. - { # A reference to an external resource that provides more information about a misconfiguration. - "type": "A String", # Required. The type of the reference (e.g., "description", "remediation"). - "uri": "A String", # Required. The URI of the reference. - }, - ], - "remediation": "A String", # Optional. Recommended remediation steps for the misconfiguration. - "vulnerableUri": "A String", # Optional. The endpoint which was found to have the vulnerability. - }, - }, - "suspiciousDomain": { # A detailed object for a suspicious Domain finding. # Domain Monitoring finding detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "matchScore": 3.14, # Required. Reference to the match score of the finding. This is a float value between 0 and 1 calculated by the matching engine. - "severity": "A String", # Required. The severity of the finding. This indicates the potential impact of the threat. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist finding. # Technology Watchlist finding detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Required. A short descriptive title for the finding <= 250 chars. EX: "Actor 'baddy' offering $1000 for credentials of 'goodguy'". - "issue": "A String", # Optional. Optional - name of the issue that this finding is bound to. Format: vaults/{vault}/issues/{issue} - "name": "A String", # Identifier. Server generated name for the finding (leave clear during creation). Format: vaults/{vault}/findings/{finding} + "name": "A String", # Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project}/findings/{finding} "provider": "A String", # Required. Logical source of this finding (name of the sub-engine). "relevanceAnalysis": { # Structured relevance analysis for a threat. # Output only. High-Precision Relevance Analysis verdict for the finding. "confidence": "A String", # The level of confidence in the given verdict. @@ -504,7 +290,6 @@

Method Details

{ # A ‘stateless’ and a point in time event that a check produced a result of interest. "aiSummary": "A String", # Optional. AI summary of the finding. "alert": "A String", # Optional. Name of the alert that this finding is bound to. - "asset": "A String", # Optional. Optional - asset name if known. Format: vaults/{vault}/assets/{asset} "audit": { # Tracks basic CRUD facts. # Output only. Audit data about the finding. "createTime": "A String", # Output only. Time of creation. "creator": "A String", # Output only. Agent that created or updated the record, could be a UserId or a JobId. @@ -515,58 +300,12 @@

Method Details

"A String", ], "detail": { # Wrapper class that contains the union struct for all the various findings detail specific classes. # Required. Holder of the domain specific details of the finding. - "compromisedCredentials": { # Sample compromised credential detail. # Compromised Credentials detail type. - "author": "A String", # Optional. Reference to the author this detail was extracted from. This is deprecated and will be removed. - "credentialService": "A String", # Optional. Claimed site the credential is intended for. - "darkWebDoc": "A String", # Optional. Reference to the dark web document. This is deprecated and will be removed. - "externalReferenceUri": "A String", # Optional. This will contain a link to the external reference for this credential. If set, this is a link back to the DTM product to allow customers to get additional context about this finding. - "fileDump": "A String", # Optional. If the source of the credential was from a file dump this will contain the name of the file the credential was found in. This can be used by customers for context on where the credential was found and to try to find other references to the file in the wild. - "fileDumpHashes": [ # Optional. A list of hashes of the file dump. These will be prefixed with the algorithm. Example: "sha256:" - "A String", - ], - "fileDumpSizeBytes": "A String", # Optional. If file_dump is set this will contain the size of the dump file in bytes. File dumps can be very large. - "forum": "A String", # Optional. Reference to the forum this detail was extracted from. This is deprecated and will be removed. - "malwareFamily": "A String", # Optional. This will indicate the malware family that leaked this credential, if known. - "postedTime": "A String", # Optional. This indicates our best guess as to when the credential was leaked to the particular venue that triggered this finding. This is not necessarily the time the credential was actually leaked and it may not always be be accurate. - "sourceUri": "A String", # Optional. If the source of a credential is publicly addressable this will contain a uri to the where the credential was found. - "userKey": "A String", # Required. This field will always be set and will be used to identify the user named in the credential leak. In cases where customers are authorized to see the actual user key this will be set to the actual user key. In cases where the customer is not authorized to see the actual user key this will be set to a hash of the user key. The hashed value is an intentionally opaque value that is not intended to be used for any other purpose than to uniquely identify the user in the context of this specific customer, service domain, and user name. Example: "user@example.com" or "redacted:". - "userSecretEvidence": "A String", # Optional. Claimed evidence of the password/secret. This will always be hashed. In the event where the plaintext password is known it will be set to "redacted:" where the same hash will be presented when the same password is found for the same organization for the same service. Redaction is done by hashing the password with a salt that is unique to the customer organization and service. In the event where the plaintext password is not known it will be set to ":" where the algorithm is the hash algorithm used and the hash is the hash of the password using that algorithm. In the event we don't know the exact algorithm used we will set it to "hashed:". - }, "dataLeak": { # A detail object for a Data Leak finding. # Data Leak finding detail type. "documentId": "A String", # Required. The unique identifier of the document that triggered the Data Leak finding. This ID can be used to retrieve the content of the document for further analysis. "matchScore": 3.14, # Required. Reference to the match score of the Data Leak finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. "severity": "A String", # Required. The severity of the Data Leak finding. This indicates the potential impact of the threat. }, "detailType": "A String", # Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. - "inbandVulnerability": { # This is a temporary detail type that will be used to support vulnerabilities until the engines start using the full vulnerability objects. The "Inband" refers to the fact that all vulnerability details are included with every finding. # Inband vulnerability detail type. - "formattedProofDetails": "A String", # Optional. A short description of the proof of the vulnerability. - "requestUri": "A String", # Optional. The URI that lead to this detection, if appropriate. - "vulnerability": { # Fleshed out vulnerability object that includes enough details to fill out a vulnerability specific view for an issue. # Required. Vulnerability metadata. - "affectedSoftware": [ # Optional. The software that is affected by the vulnerability. - { # The software that is affected by the vulnerability. - "product": "A String", # Optional. The product of the software. - "vendor": "A String", # Optional. The vendor of the software. - }, - ], - "authors": [ # Optional. The authors of the vulnerability detection. - "A String", - ], - "cveId": "A String", # Required. The CVE ID of the vulnerability. - "cvssV31Score": 3.14, # Required. The CVSS V3.1 score (Base score)for the vulnerability. ( ) - "cvssV31ScoreTemporal": 3.14, # Optional. Temporal CVSS V3.1 score for the vulnerability. - "description": "A String", # Optional. The human readable description. This can be basic HTML formatted text. - "disclosureTime": "A String", # Optional. The date the vulnerability was first disclosed. - "exploitationState": "A String", # Optional. Exploitation state of the vulnerability, for example "Available". - "externalVulnerabilityId": "A String", # Required. The external ID of the vulnerability. - "isExploitedWild": True or False, # Optional. Whether this is exploited in the wild. - "referenceUrls": [ # Optional. Reference URLs to the vulnerability. - "A String", - ], - "remediation": "A String", # Optional. The human readable remediation recommendation. This can be basic HTML formatted text. - "riskRating": "A String", # Optional. Risk rating for the vulnerability, for example "High". - "title": "A String", # Optional. Human readable name for the vulnerability. - }, - }, "initialAccessBroker": { # A detail object for an Initial Access Broker (IAB) finding. # Initial Access Broker finding detail type. "documentId": "A String", # Required. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis. "matchScore": 3.14, # Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. @@ -577,69 +316,9 @@

Method Details

"matchScore": 3.14, # Required. Reference to the match score of the InsiderThreat finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations. "severity": "A String", # Required. The severity of the InsiderThreat finding. This indicates the potential impact of the threat. }, - "misconfiguration": { # Misconfiguration finding detail. # Misconfiguration finding detail type. - "misconfigurationMetadata": { # Misconfiguration metadata. # Required. The misconfiguration metadata. - "description": "A String", # Optional. Description of the misconfiguration. - "displayName": "A String", # Optional. A user-friendly name for the misconfiguration. - "misconfigurationId": "A String", # Required. The identifier for the misconfiguration. This is an internal name generated by the finding provider. - "references": [ # Optional. References to external resources that provide more information about the misconfiguration. - { # A reference to an external resource that provides more information about a misconfiguration. - "type": "A String", # Required. The type of the reference (e.g., "description", "remediation"). - "uri": "A String", # Required. The URI of the reference. - }, - ], - "remediation": "A String", # Optional. Recommended remediation steps for the misconfiguration. - "vulnerableUri": "A String", # Optional. The endpoint which was found to have the vulnerability. - }, - }, - "suspiciousDomain": { # A detailed object for a suspicious Domain finding. # Domain Monitoring finding detail type. - "dns": { # The DNS details of the suspicious domain. # The DNS details of the suspicious domain. - "dnsRecords": [ # The DNS records of the suspicious domain. - { # The DNS record of the suspicious domain. - "record": "A String", # The name of the DNS record. - "ttl": 42, # The TTL of the DNS record. - "type": "A String", # The type of the DNS record. - "value": "A String", # The value of the DNS record. - }, - ], - "retrievalTime": "A String", # The time the DNS details were retrieved. - }, - "domain": "A String", # Required. The suspicious domain name. - "gtiDetails": { # The GTI details of the suspicious domain. # The GTI details of the suspicious domain. - "threatScore": 42, # The threat score of the suspicious domain. The threat score is a number between 0 and 100. - "verdict": "A String", # Output only. The verdict of the suspicious domain. - "virustotalUri": "A String", # VirusTotal link for the domain - }, - "matchScore": 3.14, # Required. Reference to the match score of the finding. This is a float value between 0 and 1 calculated by the matching engine. - "severity": "A String", # Required. The severity of the finding. This indicates the potential impact of the threat. - "whois": { # The whois details of the suspicious domain. # The whois details of the suspicious domain. - "retrievalTime": "A String", # The time the whois details were retrieved. - "whois": "A String", # The whois details of the suspicious domain. - }, - }, - "targetTechnology": { # Contains details for a technology watchlist finding. # Technology Watchlist finding detail type. - "vulnerabilityMatch": { # Contains details about a vulnerability match. # Optional. The vulnerability match details. - "associations": [ # Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting. - { # Represents an association with a vulnerability. - "id": "A String", # Required. The ID of the association. - "type": "A String", # Required. The type of the association. - }, - ], - "collectionId": "A String", # Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876". - "cveId": "A String", # Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information. - "cvss3Score": 3.14, # Required. The CVSS v3 score of the vulnerability. Example: 6.4. - "description": "A String", # Required. A description of the vulnerability. - "exploitationState": "A String", # Required. The exploitation state of the vulnerability. - "riskRating": "A String", # Required. The risk rating of the vulnerability. - "technologies": [ # Required. The affected technologies. Ex: "Apache Struts". - "A String", - ], - }, - }, }, "displayName": "A String", # Required. A short descriptive title for the finding <= 250 chars. EX: "Actor 'baddy' offering $1000 for credentials of 'goodguy'". - "issue": "A String", # Optional. Optional - name of the issue that this finding is bound to. Format: vaults/{vault}/issues/{issue} - "name": "A String", # Identifier. Server generated name for the finding (leave clear during creation). Format: vaults/{vault}/findings/{finding} + "name": "A String", # Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project}/findings/{finding} "provider": "A String", # Required. Logical source of this finding (name of the sub-engine). "relevanceAnalysis": { # Structured relevance analysis for a threat. # Output only. High-Precision Relevance Analysis verdict for the finding. "confidence": "A String", # The level of confidence in the given verdict. diff --git a/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json b/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json index 65f50b08a4e..ebf97ae003f 100644 --- a/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json +++ b/googleapiclient/discovery_cache/documents/threatintelligence.v1beta.json @@ -430,62 +430,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, -"refreshUriStatus": { -"description": "Return the status of a URI submitted to Google WebRisk.", -"flatPath": "v1beta/projects/{projectsId}/alerts/{alertsId}:refreshUriStatus", -"httpMethod": "POST", -"id": "threatintelligence.projects.alerts.refreshUriStatus", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "Required. Name of alert to refresh status from WebRisk", -"location": "path", -"pattern": "^projects/[^/]+/alerts/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1beta/{+name}:refreshUriStatus", -"request": { -"$ref": "RefreshAlertUriStatusRequest" -}, -"response": { -"$ref": "RefreshAlertUriStatusResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"reportAlertUri": { -"description": "Report the URI associated with an alert to Google WebRisk.", -"flatPath": "v1beta/projects/{projectsId}/alerts/{alertsId}:reportAlertUri", -"httpMethod": "POST", -"id": "threatintelligence.projects.alerts.reportAlertUri", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "Required. Name of alert to submit to WebRisk.", -"location": "path", -"pattern": "^projects/[^/]+/alerts/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1beta/{+name}:reportAlertUri", -"request": { -"$ref": "ReportAlertUriRequest" -}, -"response": { -"$ref": "ReportAlertUriResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, "resolve": { "description": "Marks an alert to closed state - RESOLVED.", "flatPath": "v1beta/projects/{projectsId}/alerts/{alertsId}:resolve", @@ -888,24 +832,9 @@ } } }, -"revision": "20260211", +"revision": "20260218", "rootUrl": "https://threatintelligence.googleapis.com/", "schemas": { -"AffectedSoftware": { -"description": "The software that is affected by the vulnerability.", -"id": "AffectedSoftware", -"properties": { -"product": { -"description": "Optional. The product of the software.", -"type": "string" -}, -"vendor": { -"description": "Optional. The vendor of the software.", -"type": "string" -} -}, -"type": "object" -}, "Alert": { "description": "Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet.", "id": "Alert", @@ -914,14 +843,6 @@ "description": "Optional. AI summary of the finding.", "type": "string" }, -"assets": { -"description": "Output only. Assets that are impacted by this alert.", -"items": { -"type": "string" -}, -"readOnly": true, -"type": "array" -}, "audit": { "$ref": "Audit", "description": "Output only. Audit information for the alert.", @@ -1054,14 +975,6 @@ "insiderThreat": { "$ref": "InsiderThreatAlertDetail", "description": "Insider Threat alert detail type." -}, -"suspiciousDomain": { -"$ref": "SuspiciousDomainAlertDetail", -"description": "Domain Monitoring alert detail type." -}, -"targetTechnology": { -"$ref": "TargetTechnologyAlertDetail", -"description": "Technology Watchlist alert detail type." } }, "type": "object" @@ -1158,133 +1071,6 @@ }, "type": "object" }, -"AssetDiscoveryConfig": { -"description": "Customer defined Configuration for asset discovery.", -"id": "AssetDiscoveryConfig", -"properties": { -"lastScanCompleteTime": { -"description": "Output only. Timestamp of the last scan completed. This field is set by the system and cannot be modified by the user.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -}, -"lastScanStartTime": { -"description": "Output only. Timestamp of the last scan started - used for scheduling the next scan. This field is set by the system and cannot be modified by the user.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -}, -"scanFrequency": { -"description": "Required. Frequency at which the scheduled discovery scan should be run. If not specified, the default frequency is DAILY.", -"enum": [ -"ASSET_DISCOVERY_SCAN_FREQUENCY_UNSPECIFIED", -"ON_DEMAND", -"WEEKLY", -"DAILY", -"MONTHLY" -], -"enumDescriptions": [ -"Default value, should never be set.", -"Scan is triggered on demand.", -"Scan is triggered weekly.", -"Scan is triggered daily.", -"Scan is triggered monthly." -], -"type": "string" -}, -"scopeExclusionAssets": { -"description": "Optional. Seed assets that are out of scope for the scheduled discovery scan.", -"items": { -"$ref": "AssetDiscoverySeed" -}, -"type": "array" -}, -"seedAssets": { -"description": "Required. Seed assets for the scheduled discovery scan. At least one seed asset is required.", -"items": { -"$ref": "AssetDiscoverySeed" -}, -"type": "array" -}, -"workflow": { -"description": "Required. Workflow to be used for the scheduled discovery scan. If not specified, the default workflow is EXTERNAL_DISCOVERY.", -"enum": [ -"ASSET_DISCOVERY_WORKFLOW_UNSPECIFIED", -"EXTERNAL_DISCOVERY", -"EXTERNAL_DISCOVERY_AND_ASSESSMENT", -"MOBILE_APP_DISCOVERY" -], -"enumDescriptions": [ -"Default value, should never be set.", -"Discovery workflow that only discovers external facing assets.", -"Discovery workflow that discovers external facing assets and generates relevant alerts on them.", -"Discovery workflow that discovers mobile app assets." -], -"type": "string" -} -}, -"type": "object" -}, -"AssetDiscoverySeed": { -"description": "Seed assets for asset discovery.", -"id": "AssetDiscoverySeed", -"properties": { -"seedType": { -"description": "Required. Type of the seed asset.", -"enum": [ -"ASSET_DISCOVERY_SEED_TYPE_UNSPECIFIED", -"IP_ADDRESS", -"NETWORK_SERVICE" -], -"enumDescriptions": [ -"Default value, should never be set.", -"Seed asset is an IP address.", -"Seed asset is a network service." -], -"type": "string" -}, -"seedValue": { -"description": "Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc.", -"type": "string" -} -}, -"type": "object" -}, -"Association": { -"description": "Represents an association with a vulnerability.", -"id": "Association", -"properties": { -"id": { -"description": "Required. The ID of the association.", -"type": "string" -}, -"type": { -"description": "Required. The type of the association.", -"enum": [ -"THREAT_INTEL_OBJECT_TYPE_UNSPECIFIED", -"THREAT_INTEL_OBJECT_TYPE_THREAT_ACTOR", -"THREAT_INTEL_OBJECT_TYPE_MALWARE", -"THREAT_INTEL_OBJECT_TYPE_REPORT", -"THREAT_INTEL_OBJECT_TYPE_CAMPAIGN", -"THREAT_INTEL_OBJECT_TYPE_IOC_COLLECTION", -"THREAT_INTEL_OBJECT_TYPE_SOFTWARE_AND_TOOLKITS", -"THREAT_INTEL_OBJECT_TYPE_VULNERABILITY" -], -"enumDescriptions": [ -"Unspecified object type.", -"Threat actor object type.", -"Malware object type.", -"Report object type.", -"Campaign object type.", -"IoC Collection object type.", -"Software and toolkits object type.", -"Vulnerability object type." -], -"type": "string" -} -}, -"type": "object" -}, "Audit": { "description": "Tracks basic CRUD facts.", "id": "Audit", @@ -1314,73 +1100,6 @@ }, "type": "object" }, -"CompromisedCredentialsFindingDetail": { -"description": "Sample compromised credential detail.", -"id": "CompromisedCredentialsFindingDetail", -"properties": { -"author": { -"deprecated": true, -"description": "Optional. Reference to the author this detail was extracted from. This is deprecated and will be removed.", -"type": "string" -}, -"credentialService": { -"description": "Optional. Claimed site the credential is intended for.", -"type": "string" -}, -"darkWebDoc": { -"deprecated": true, -"description": "Optional. Reference to the dark web document. This is deprecated and will be removed.", -"type": "string" -}, -"externalReferenceUri": { -"description": "Optional. This will contain a link to the external reference for this credential. If set, this is a link back to the DTM product to allow customers to get additional context about this finding.", -"type": "string" -}, -"fileDump": { -"description": "Optional. If the source of the credential was from a file dump this will contain the name of the file the credential was found in. This can be used by customers for context on where the credential was found and to try to find other references to the file in the wild.", -"type": "string" -}, -"fileDumpHashes": { -"description": "Optional. A list of hashes of the file dump. These will be prefixed with the algorithm. Example: \"sha256:\"", -"items": { -"type": "string" -}, -"type": "array" -}, -"fileDumpSizeBytes": { -"description": "Optional. If file_dump is set this will contain the size of the dump file in bytes. File dumps can be very large.", -"format": "int64", -"type": "string" -}, -"forum": { -"deprecated": true, -"description": "Optional. Reference to the forum this detail was extracted from. This is deprecated and will be removed.", -"type": "string" -}, -"malwareFamily": { -"description": "Optional. This will indicate the malware family that leaked this credential, if known.", -"type": "string" -}, -"postedTime": { -"description": "Optional. This indicates our best guess as to when the credential was leaked to the particular venue that triggered this finding. This is not necessarily the time the credential was actually leaked and it may not always be be accurate.", -"format": "google-datetime", -"type": "string" -}, -"sourceUri": { -"description": "Optional. If the source of a credential is publicly addressable this will contain a uri to the where the credential was found.", -"type": "string" -}, -"userKey": { -"description": "Required. This field will always be set and will be used to identify the user named in the credential leak. In cases where customers are authorized to see the actual user key this will be set to the actual user key. In cases where the customer is not authorized to see the actual user key this will be set to a hash of the user key. The hashed value is an intentionally opaque value that is not intended to be used for any other purpose than to uniquely identify the user in the context of this specific customer, service domain, and user name. Example: \"user@example.com\" or \"redacted:\".", -"type": "string" -}, -"userSecretEvidence": { -"description": "Optional. Claimed evidence of the password/secret. This will always be hashed. In the event where the plaintext password is known it will be set to \"redacted:\" where the same hash will be presented when the same password is found for the same organization for the same service. Redaction is done by hashing the password with a salt that is unique to the customer organization and service. In the event where the plaintext password is not known it will be set to \":\" where the algorithm is the hash algorithm used and the hash is the hash of the password using that algorithm. In the event we don't know the exact algorithm used we will set it to \"hashed:\".", -"type": "string" -} -}, -"type": "object" -}, "Configuration": { "description": "A configuration represents a behavior an engine should follow when producing new findings.", "id": "Configuration", @@ -1404,7 +1123,7 @@ "type": "string" }, "name": { -"description": "Identifier. Server generated name for the configuration. format is vaults/{vault}/configurations/{configuration}", +"description": "Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration}", "type": "string" }, "provider": { @@ -1438,10 +1157,6 @@ "description": "Wrapper class that contains the union struct for all the various configuration detail specific classes.", "id": "ConfigurationDetail", "properties": { -"assetDiscovery": { -"$ref": "AssetDiscoveryConfig", -"description": "Asset Discovery detail config." -}, "customerProfile": { "$ref": "CustomerProfileConfig", "description": "Customer Profile detail config." @@ -1450,18 +1165,6 @@ "description": "Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union.", "readOnly": true, "type": "string" -}, -"domainMonitoring": { -"$ref": "DomainMonitoringConfig", -"description": "Domain Monitoring detail config." -}, -"initialAccessBroker": { -"$ref": "InitialAccessBrokerConfig", -"description": "Initial Access Broker (IAB) detail config." -}, -"technologyWatchlist": { -"$ref": "TechnologyWatchListConfig", -"description": "Technology Watchlist detail config." } }, "type": "object" @@ -1477,7 +1180,7 @@ "type": "string" }, "name": { -"description": "Identifier. The name of the ConfigurationRevision Format: vaults//configurations//revisions/ OR projects//configurations//revisions/", +"description": "Identifier. The name of the ConfigurationRevision Format: projects//configurations//revisions/", "type": "string" }, "snapshot": { @@ -1899,88 +1602,6 @@ }, "type": "object" }, -"DomainMonitoringConfig": { -"description": "Any account-level configuration options will go here.", -"id": "DomainMonitoringConfig", -"properties": { -"domains": { -"description": "The domains to use as \"seeds\" for Suspicious Domain Monitoring.", -"items": { -"$ref": "DomainMonitoringDomain" -}, -"type": "array" -} -}, -"type": "object" -}, -"DomainMonitoringDomain": { -"description": "A Domain Monitoring \"domain\"", -"id": "DomainMonitoringDomain", -"properties": { -"domain": { -"description": "The domain name to match against.", -"type": "string" -} -}, -"type": "object" -}, -"EntityProfile": { -"description": "EntityProfile represents the structured profile of a customer entity, containing key identifiers and descriptive attributes optimized for contextual matching against threat intelligence, particularly Initial Access Broker (IAB) offerings.", -"id": "EntityProfile", -"properties": { -"countries": { -"description": "Optional. List of specific countries of operation. Purpose: Essential for matching geographically targeted threats (e.g., actor specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., \"US\", \"GB\", \"JP\", \"DE\").", -"items": { -"type": "string" -}, -"type": "array" -}, -"domains": { -"description": "Required. List of primary internet domain names associated with the entity. Purpose: Crucial for explicit matching against domains mentioned in threat intel and can inform semantic matching. Must contain at least one domain. Example: [\"acme.com\", \"acme.co.uk\"]", -"items": { -"type": "string" -}, -"type": "array" -}, -"industries": { -"description": "Optional. List of primary industry sectors the entity operates within. Purpose: Crucial for matching industry-specific threats and understanding attacker motivation. Use standardized GTI Industry Classification values. Example: [\"Technology\", \"Financial Services\", \"Healthcare\"]", -"items": { -"type": "string" -}, -"type": "array" -}, -"name": { -"description": "Required. Canonical name of the entity (e.g., the legal company name). Purpose: Primary identifier for the customer.", -"type": "string" -}, -"operationalAreas": { -"description": "Optional. Specific geographic areas of *significant* operational concentration or strategic importance below the country level, if clearly identifiable and relevant. Purpose: Useful for highly localized threats, less commonly populated than `countries`. Example: [\"Silicon Valley\", \"Frankfurt am Main Metropolitan Region\"]", -"items": { -"type": "string" -}, -"type": "array" -}, -"profileSummary": { -"description": "Required. A concise, machine-generated (e.g., LLM) or human-curated summary of the entity. Purpose: Captures the semantic essence for embedding generation and similarity matching. Should synthesize key aspects like core business, scale, and market. Example: \"Acme Corporation is a large, US-based multinational conglomerate operating...\"", -"type": "string" -}, -"regions": { -"description": "Optional. List of primary geopolitical regions where the entity has significant operations. Purpose: Filters geographically relevant threats. Use standardized names or codes where possible (e.g., \"North America\", \"EMEA\", \"APAC\", UN M49 codes).", -"items": { -"type": "string" -}, -"type": "array" -}, -"subIndustries": { -"description": "Optional. List of more granular sub-industries, if applicable and known. Purpose: Provides finer-grained context for more specific threat matching. Should align with GTI classifications if possible. Example: [\"Semiconductors\", \"Cloud Computing Services\", \"Investment Banking\"]", -"items": { -"type": "string" -}, -"type": "array" -} -}, -"type": "object" -}, "EnumerateAlertFacetsResponse": { "description": "Response message for EnumerateAlertFacets.", "id": "EnumerateAlertFacetsResponse", @@ -2079,10 +1700,6 @@ "description": "Optional. Name of the alert that this finding is bound to.", "type": "string" }, -"asset": { -"description": "Optional. Optional - asset name if known. Format: vaults/{vault}/assets/{asset}", -"type": "string" -}, "audit": { "$ref": "Audit", "description": "Output only. Audit data about the finding.", @@ -2103,12 +1720,8 @@ "description": "Required. A short descriptive title for the finding <= 250 chars. EX: \"Actor 'baddy' offering $1000 for credentials of 'goodguy'\".", "type": "string" }, -"issue": { -"description": "Optional. Optional - name of the issue that this finding is bound to. Format: vaults/{vault}/issues/{issue}", -"type": "string" -}, "name": { -"description": "Identifier. Server generated name for the finding (leave clear during creation). Format: vaults/{vault}/findings/{finding}", +"description": "Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project}/findings/{finding}", "type": "string" }, "provider": { @@ -2147,10 +1760,6 @@ "description": "Wrapper class that contains the union struct for all the various findings detail specific classes.", "id": "FindingDetail", "properties": { -"compromisedCredentials": { -"$ref": "CompromisedCredentialsFindingDetail", -"description": "Compromised Credentials detail type." -}, "dataLeak": { "$ref": "DataLeakFindingDetail", "description": "Data Leak finding detail type." @@ -2160,10 +1769,6 @@ "readOnly": true, "type": "string" }, -"inbandVulnerability": { -"$ref": "InbandVulnerabilityFindingDetail", -"description": "Inband vulnerability detail type." -}, "initialAccessBroker": { "$ref": "InitialAccessBrokerFindingDetail", "description": "Initial Access Broker finding detail type." @@ -2171,18 +1776,6 @@ "insiderThreat": { "$ref": "InsiderThreatFindingDetail", "description": "Insider Threat finding detail type." -}, -"misconfiguration": { -"$ref": "MisconfigurationFindingDetail", -"description": "Misconfiguration finding detail type." -}, -"suspiciousDomain": { -"$ref": "SuspiciousDomainFindingDetail", -"description": "Domain Monitoring finding detail type." -}, -"targetTechnology": { -"$ref": "TargetTechnologyFindingDetail", -"description": "Technology Watchlist finding detail type." } }, "type": "object" @@ -2202,139 +1795,34 @@ }, "type": "object" }, -"InbandVulnerability": { -"description": "Fleshed out vulnerability object that includes enough details to fill out a vulnerability specific view for an issue.", -"id": "InbandVulnerability", +"InitialAccessBrokerAlertDetail": { +"description": "Captures the specific details of InitialAccessBroker (IAB) alert.", +"id": "InitialAccessBrokerAlertDetail", "properties": { -"affectedSoftware": { -"description": "Optional. The software that is affected by the vulnerability.", +"discoveryDocumentIds": { +"description": "Required. Array of ids to accommodate multiple discovery documents", "items": { -"$ref": "AffectedSoftware" +"type": "string" }, "type": "array" }, -"authors": { -"description": "Optional. The authors of the vulnerability detection.", -"items": { +"severity": { +"description": "Required. IAB specific severity", "type": "string" +} }, -"type": "array" +"type": "object" }, -"cveId": { -"description": "Required. The CVE ID of the vulnerability.", +"InitialAccessBrokerFindingDetail": { +"description": "A detail object for an Initial Access Broker (IAB) finding.", +"id": "InitialAccessBrokerFindingDetail", +"properties": { +"documentId": { +"description": "Required. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis.", "type": "string" }, -"cvssV31Score": { -"description": "Required. The CVSS V3.1 score (Base score)for the vulnerability. ( )", -"format": "float", -"type": "number" -}, -"cvssV31ScoreTemporal": { -"description": "Optional. Temporal CVSS V3.1 score for the vulnerability.", -"format": "float", -"type": "number" -}, -"description": { -"description": "Optional. The human readable description. This can be basic HTML formatted text.", -"type": "string" -}, -"disclosureTime": { -"description": "Optional. The date the vulnerability was first disclosed.", -"format": "google-datetime", -"type": "string" -}, -"exploitationState": { -"description": "Optional. Exploitation state of the vulnerability, for example \"Available\".", -"type": "string" -}, -"externalVulnerabilityId": { -"description": "Required. The external ID of the vulnerability.", -"type": "string" -}, -"isExploitedWild": { -"description": "Optional. Whether this is exploited in the wild.", -"type": "boolean" -}, -"referenceUrls": { -"description": "Optional. Reference URLs to the vulnerability.", -"items": { -"type": "string" -}, -"type": "array" -}, -"remediation": { -"description": "Optional. The human readable remediation recommendation. This can be basic HTML formatted text.", -"type": "string" -}, -"riskRating": { -"description": "Optional. Risk rating for the vulnerability, for example \"High\".", -"type": "string" -}, -"title": { -"description": "Optional. Human readable name for the vulnerability.", -"type": "string" -} -}, -"type": "object" -}, -"InbandVulnerabilityFindingDetail": { -"description": "This is a temporary detail type that will be used to support vulnerabilities until the engines start using the full vulnerability objects. The \"Inband\" refers to the fact that all vulnerability details are included with every finding.", -"id": "InbandVulnerabilityFindingDetail", -"properties": { -"formattedProofDetails": { -"description": "Optional. A short description of the proof of the vulnerability.", -"type": "string" -}, -"requestUri": { -"description": "Optional. The URI that lead to this detection, if appropriate.", -"type": "string" -}, -"vulnerability": { -"$ref": "InbandVulnerability", -"description": "Required. Vulnerability metadata." -} -}, -"type": "object" -}, -"InitialAccessBrokerAlertDetail": { -"description": "Captures the specific details of InitialAccessBroker (IAB) alert.", -"id": "InitialAccessBrokerAlertDetail", -"properties": { -"discoveryDocumentIds": { -"description": "Required. Array of ids to accommodate multiple discovery documents", -"items": { -"type": "string" -}, -"type": "array" -}, -"severity": { -"description": "Required. IAB specific severity", -"type": "string" -} -}, -"type": "object" -}, -"InitialAccessBrokerConfig": { -"description": "InitialAccessBrokerConfig is specific to Initial Access Broker (IAB) matching scenarios.", -"id": "InitialAccessBrokerConfig", -"properties": { -"entityProfile": { -"$ref": "EntityProfile", -"description": "Represents the comprehensive profile of the customer entity used for matching." -} -}, -"type": "object" -}, -"InitialAccessBrokerFindingDetail": { -"description": "A detail object for an Initial Access Broker (IAB) finding.", -"id": "InitialAccessBrokerFindingDetail", -"properties": { -"documentId": { -"description": "Required. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis.", -"type": "string" -}, -"matchScore": { -"description": "Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations.", +"matchScore": { +"description": "Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations.", "format": "float", "type": "number" }, @@ -2542,66 +2030,6 @@ "properties": {}, "type": "object" }, -"MisconfigurationFindingDetail": { -"description": "Misconfiguration finding detail.", -"id": "MisconfigurationFindingDetail", -"properties": { -"misconfigurationMetadata": { -"$ref": "MisconfigurationMetadata", -"description": "Required. The misconfiguration metadata." -} -}, -"type": "object" -}, -"MisconfigurationMetadata": { -"description": "Misconfiguration metadata.", -"id": "MisconfigurationMetadata", -"properties": { -"description": { -"description": "Optional. Description of the misconfiguration.", -"type": "string" -}, -"displayName": { -"description": "Optional. A user-friendly name for the misconfiguration.", -"type": "string" -}, -"misconfigurationId": { -"description": "Required. The identifier for the misconfiguration. This is an internal name generated by the finding provider.", -"type": "string" -}, -"references": { -"description": "Optional. References to external resources that provide more information about the misconfiguration.", -"items": { -"$ref": "MisconfigurationReference" -}, -"type": "array" -}, -"remediation": { -"description": "Optional. Recommended remediation steps for the misconfiguration.", -"type": "string" -}, -"vulnerableUri": { -"description": "Optional. The endpoint which was found to have the vulnerability.", -"type": "string" -} -}, -"type": "object" -}, -"MisconfigurationReference": { -"description": "A reference to an external resource that provides more information about a misconfiguration.", -"id": "MisconfigurationReference", -"properties": { -"type": { -"description": "Required. The type of the reference (e.g., \"description\", \"remediation\").", -"type": "string" -}, -"uri": { -"description": "Required. The URI of the reference.", -"type": "string" -} -}, -"type": "object" -}, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -2682,40 +2110,6 @@ }, "type": "object" }, -"RefreshAlertUriStatusRequest": { -"description": "Request message for FetchAlertUriStatus.", -"id": "RefreshAlertUriStatusRequest", -"properties": {}, -"type": "object" -}, -"RefreshAlertUriStatusResponse": { -"description": "Response message for FetchAlertUriStatus.", -"id": "RefreshAlertUriStatusResponse", -"properties": { -"state": { -"description": "Output only. Status of the alert in WebRisk.", -"enum": [ -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" -], -"enumDescriptions": [ -"Unspecified status.", -"Issue has not been submitted to WebRisk.", -"Issue has been submitted to WebRisk.", -"Issue has been submitted to WebRisk and is being processed.", -"Issue has been processed by WebRisk and the domain was added to the blocklist.", -"Issue has been processed by WebRisk and was rejected." -], -"readOnly": true, -"type": "string" -} -}, -"type": "object" -}, "RelevanceAnalysis": { "description": "Structured relevance analysis for a threat.", "id": "RelevanceAnalysis", @@ -2767,40 +2161,6 @@ }, "type": "object" }, -"ReportAlertUriRequest": { -"description": "Request message for ReportAlertUri.", -"id": "ReportAlertUriRequest", -"properties": {}, -"type": "object" -}, -"ReportAlertUriResponse": { -"description": "Response message for ReportAlertUri.", -"id": "ReportAlertUriResponse", -"properties": { -"state": { -"description": "Output only. Status of the alert in WebRisk.", -"enum": [ -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" -], -"enumDescriptions": [ -"Unspecified status.", -"Issue has not been submitted to WebRisk.", -"Issue has been submitted to WebRisk.", -"Issue has been submitted to WebRisk and is being processed.", -"Issue has been processed by WebRisk and the domain was added to the blocklist.", -"Issue has been processed by WebRisk and was rejected." -], -"readOnly": true, -"type": "string" -} -}, -"type": "object" -}, "SearchFindingsResponse": { "description": "Response message for SearchFindings.", "id": "SearchFindingsResponse", @@ -2889,297 +2249,6 @@ }, "type": "object" }, -"SuspiciousDomainAlertDetail": { -"description": "The alert detail for a suspicious domain finding.", -"id": "SuspiciousDomainAlertDetail", -"properties": { -"dns": { -"$ref": "SuspiciousDomainDnsDetails", -"description": "The DNS details of the suspicious domain." -}, -"domain": { -"description": "Required. The suspicious domain name.", -"type": "string" -}, -"gtiDetails": { -"$ref": "SuspiciousDomainGtiDetails", -"description": "The GTI details of the suspicious domain." -}, -"webRiskOperation": { -"description": "Output only. Name of Web Risk submission operation.", -"readOnly": true, -"type": "string" -}, -"webRiskState": { -"description": "Output only. Status of the Web Risk submission.", -"enum": [ -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED", -"SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" -], -"enumDescriptions": [ -"Unspecified status.", -"Issue has not been submitted to WebRisk.", -"Issue has been submitted to WebRisk.", -"Issue has been submitted to WebRisk and is being processed.", -"Issue has been processed by WebRisk and the domain was added to the blocklist.", -"Issue has been processed by WebRisk and was rejected." -], -"readOnly": true, -"type": "string" -}, -"whois": { -"$ref": "SuspiciousDomainWhoIsDetails", -"description": "The whois details of the suspicious domain." -} -}, -"type": "object" -}, -"SuspiciousDomainDnsDetails": { -"description": "The DNS details of the suspicious domain.", -"id": "SuspiciousDomainDnsDetails", -"properties": { -"dnsRecords": { -"description": "The DNS records of the suspicious domain.", -"items": { -"$ref": "SuspiciousDomainDnsRecord" -}, -"type": "array" -}, -"retrievalTime": { -"description": "The time the DNS details were retrieved.", -"format": "google-datetime", -"type": "string" -} -}, -"type": "object" -}, -"SuspiciousDomainDnsRecord": { -"description": "The DNS record of the suspicious domain.", -"id": "SuspiciousDomainDnsRecord", -"properties": { -"record": { -"description": "The name of the DNS record.", -"type": "string" -}, -"ttl": { -"description": "The TTL of the DNS record.", -"format": "int32", -"type": "integer" -}, -"type": { -"description": "The type of the DNS record.", -"type": "string" -}, -"value": { -"description": "The value of the DNS record.", -"type": "string" -} -}, -"type": "object" -}, -"SuspiciousDomainFindingDetail": { -"description": "A detailed object for a suspicious Domain finding.", -"id": "SuspiciousDomainFindingDetail", -"properties": { -"dns": { -"$ref": "SuspiciousDomainDnsDetails", -"description": "The DNS details of the suspicious domain." -}, -"domain": { -"description": "Required. The suspicious domain name.", -"type": "string" -}, -"gtiDetails": { -"$ref": "SuspiciousDomainGtiDetails", -"description": "The GTI details of the suspicious domain." -}, -"matchScore": { -"description": "Required. Reference to the match score of the finding. This is a float value between 0 and 1 calculated by the matching engine.", -"format": "float", -"type": "number" -}, -"severity": { -"description": "Required. The severity of the finding. This indicates the potential impact of the threat.", -"enum": [ -"SEVERITY_UNSPECIFIED", -"LOW", -"MEDIUM", -"HIGH", -"CRITICAL" -], -"enumDescriptions": [ -"Default value, should never be set.", -"Low severity.", -"Medium severity.", -"High severity.", -"Critical severity." -], -"type": "string" -}, -"whois": { -"$ref": "SuspiciousDomainWhoIsDetails", -"description": "The whois details of the suspicious domain." -} -}, -"type": "object" -}, -"SuspiciousDomainGtiDetails": { -"description": "The GTI details of the suspicious domain.", -"id": "SuspiciousDomainGtiDetails", -"properties": { -"threatScore": { -"description": "The threat score of the suspicious domain. The threat score is a number between 0 and 100.", -"format": "int32", -"type": "integer" -}, -"verdict": { -"description": "Output only. The verdict of the suspicious domain.", -"enum": [ -"SUSPICIOUS_DOMAIN_GTI_VERDICT_UNSPECIFIED", -"SUSPICIOUS_DOMAIN_GTI_VERDICT_BENIGN", -"SUSPICIOUS_DOMAIN_GTI_VERDICT_UNDETECTED", -"SUSPICIOUS_DOMAIN_GTI_VERDICT_SUSPICIOUS", -"SUSPICIOUS_DOMAIN_GTI_VERDICT_MALICIOUS", -"SUSPICIOUS_DOMAIN_GTI_VERDICT_UNKNOWN" -], -"enumDescriptions": [ -"Unspecified verdict.", -"Verdict is clean; the entity is considered harmless.", -"Verdict is undetected; no immediate evidence of malicious intent.", -"Verdict is suspicious; possible malicious activity detected.", -"Verdict is malicious; high confidence that the entity poses a threat.", -"Verdict is not applicable; not able to generate a verdict for this entity." -], -"readOnly": true, -"type": "string" -}, -"virustotalUri": { -"description": "VirusTotal link for the domain", -"type": "string" -} -}, -"type": "object" -}, -"SuspiciousDomainWhoIsDetails": { -"description": "The whois details of the suspicious domain.", -"id": "SuspiciousDomainWhoIsDetails", -"properties": { -"retrievalTime": { -"description": "The time the whois details were retrieved.", -"format": "google-datetime", -"type": "string" -}, -"whois": { -"description": "The whois details of the suspicious domain.", -"type": "string" -} -}, -"type": "object" -}, -"TargetTechnologyAlertDetail": { -"description": "Contains details for a technology watchlist alert.", -"id": "TargetTechnologyAlertDetail", -"properties": { -"vulnerabilityMatch": { -"$ref": "VulnerabilityMatch", -"description": "Optional. The vulnerability match details." -} -}, -"type": "object" -}, -"TargetTechnologyFindingDetail": { -"description": "Contains details for a technology watchlist finding.", -"id": "TargetTechnologyFindingDetail", -"properties": { -"vulnerabilityMatch": { -"$ref": "VulnerabilityMatch", -"description": "Optional. The vulnerability match details." -} -}, -"type": "object" -}, -"TechnologyWatchListAlertThreshold": { -"description": "TechnologyWatchListAlertThreshold contains the thresholds for alerting.", -"id": "TechnologyWatchListAlertThreshold", -"properties": { -"cvssScoreMinimum": { -"description": "Optional. The minimum cvss V3 score for the alert. Ex: 7.0. Valid range is [0.0, 10.0].", -"format": "float", -"type": "number" -}, -"epssScoreMinimum": { -"description": "Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0].", -"format": "float", -"type": "number" -}, -"exploitationStates": { -"description": "Optional. The exploitation states of the alert.", -"items": { -"enum": [ -"EXPLOITATION_STATE_UNSPECIFIED", -"EXPLOITATION_STATE_NO_KNOWN", -"EXPLOITATION_STATE_REPORTED", -"EXPLOITATION_STATE_SUSPECTED", -"EXPLOITATION_STATE_CONFIRMED", -"EXPLOITATION_STATE_WIDESPREAD" -], -"enumDescriptions": [ -"Unspecified exploitation state.", -"No known exploitation.", -"Exploitation has been reported.", -"Exploitation is suspected.", -"Exploitation is confirmed.", -"Widespread exploitation." -], -"type": "string" -}, -"type": "array" -}, -"priorityMinimum": { -"description": "Optional. The minimum priority for the alert.", -"enum": [ -"PRIORITY_UNSPECIFIED", -"P0", -"P1", -"P2", -"P3", -"P4" -], -"enumDescriptions": [ -"Unspecified priority.", -"Priority level 0.", -"Priority level 1.", -"Priority level 2.", -"Priority level 3.", -"Priority level 4." -], -"type": "string" -} -}, -"type": "object" -}, -"TechnologyWatchListConfig": { -"description": "TechnologyWatchListConfig is the configuration for the technology watchlist.", -"id": "TechnologyWatchListConfig", -"properties": { -"alertThreshold": { -"$ref": "TechnologyWatchListAlertThreshold", -"description": "Optional. Alert thresholds to effectively reduce noise." -}, -"technologies": { -"description": "Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:*", -"items": { -"type": "string" -}, -"type": "array" -} -}, -"type": "object" -}, "UpsertConfigurationResponse": { "description": "Response message for UpsertConfiguration.", "id": "UpsertConfigurationResponse", @@ -3191,84 +2260,6 @@ } }, "type": "object" -}, -"VulnerabilityMatch": { -"description": "Contains details about a vulnerability match.", -"id": "VulnerabilityMatch", -"properties": { -"associations": { -"description": "Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting.", -"items": { -"$ref": "Association" -}, -"type": "array" -}, -"collectionId": { -"description": "Required. The collection ID of the vulnerability. Ex: \"vulnerability--cve-2025-9876\".", -"type": "string" -}, -"cveId": { -"description": "Required. The CVE ID of the vulnerability. Ex: \"CVE-2025-9876\". See https://www.cve.org/ for more information.", -"type": "string" -}, -"cvss3Score": { -"description": "Required. The CVSS v3 score of the vulnerability. Example: 6.4.", -"format": "float", -"type": "number" -}, -"description": { -"description": "Required. A description of the vulnerability.", -"type": "string" -}, -"exploitationState": { -"description": "Required. The exploitation state of the vulnerability.", -"enum": [ -"EXPLOITATION_STATE_UNSPECIFIED", -"EXPLOITATION_STATE_NO_KNOWN", -"EXPLOITATION_STATE_REPORTED", -"EXPLOITATION_STATE_SUSPECTED", -"EXPLOITATION_STATE_CONFIRMED", -"EXPLOITATION_STATE_WIDESPREAD" -], -"enumDescriptions": [ -"Unspecified exploitation state.", -"No known exploitation.", -"Exploitation has been reported.", -"Exploitation is suspected.", -"Exploitation is confirmed.", -"Widespread exploitation." -], -"type": "string" -}, -"riskRating": { -"description": "Required. The risk rating of the vulnerability.", -"enum": [ -"RISK_RATING_UNSPECIFIED", -"LOW", -"MEDIUM", -"HIGH", -"CRITICAL", -"UNRATED" -], -"enumDescriptions": [ -"Unspecified risk rating. This is the default value when the risk rating is not set.", -"Low risk rating.", -"Medium risk rating.", -"High risk rating.", -"Critical risk rating.", -"The vulnerability has been assessed, but a specific risk rating could not be determined or assigned." -], -"type": "string" -}, -"technologies": { -"description": "Required. The affected technologies. Ex: \"Apache Struts\".", -"items": { -"type": "string" -}, -"type": "array" -} -}, -"type": "object" } }, "servicePath": "", From 8bb081c44320e11b68fc0b625925af1638a2e910 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 24 Feb 2026 07:27:58 +0000 Subject: [PATCH 29/29] chore(docs): Add new discovery artifacts and artifacts with minor updates --- ...projects.locations.clusters.instances.html | 10 +- ...projects.locations.clusters.instances.html | 10 +- ...projects.locations.clusters.instances.html | 10 +- .../dyn/androidmanagement_v1.enterprises.html | 12 +- docs/dyn/apphub_v1.projects.locations.html | 4 +- .../apphub_v1alpha.projects.locations.html | 4 +- docs/dyn/calendar_v3.events.html | 26 +- .../cloudscheduler_v1.projects.locations.html | 4 +- ...dscheduler_v1beta1.projects.locations.html | 4 +- ...ghts_v1.projects.locations.dashboards.html | 2 +- docs/dyn/dataform_v1.projects.locations.html | 4 +- ...tions.repositories.compilationResults.html | 2 +- ...rm_v1beta1.projects.locations.folders.html | 2 +- .../dataform_v1beta1.projects.locations.html | 4 +- ...tions.repositories.compilationResults.html | 2 +- ...beta1.projects.locations.repositories.html | 2 +- ...y_v1.organizations.protectedResources.html | 2 +- ...rojects.locations.keyRings.cryptoKeys.html | 2 +- ...entory_v1.projects.protectedResources.html | 2 +- .../dyn/merchantapi_accounts_v1.accounts.html | 14 +- ...v1.accounts.programs.checkoutSettings.html | 10 +- ...hantapi_accounts_v1.accounts.programs.html | 8 +- .../merchantapi_accounts_v1beta.accounts.html | 14 +- ...ta.accounts.programs.checkoutSettings.html | 10 +- ...api_accounts_v1beta.accounts.programs.html | 8 +- ...ta1.projects.locations.unitOperations.html | 12 +- ...ervicedirectory_v1.projects.locations.html | 4 +- ...edirectory_v1beta1.projects.locations.html | 4 +- ...ets_v4.spreadsheets.developerMetadata.html | 36 +- docs/dyn/sheets_v4.spreadsheets.html | 502 +++++++++--------- docs/dyn/sheets_v4.spreadsheets.values.html | 58 +- docs/dyn/walletobjects_v1.jwt.html | 4 +- .../discovery_cache/documents/alloydb.v1.json | 4 +- .../documents/alloydb.v1alpha.json | 4 +- .../documents/alloydb.v1beta.json | 4 +- .../documents/androidmanagement.v1.json | 4 +- .../discovery_cache/documents/apphub.v1.json | 4 +- .../documents/apphub.v1alpha.json | 4 +- .../documents/calendar.v3.json | 4 +- .../documents/cloudfunctions.v2.json | 20 +- .../documents/cloudfunctions.v2alpha.json | 20 +- .../documents/cloudfunctions.v2beta.json | 20 +- .../documents/cloudscheduler.v1.json | 4 +- .../documents/cloudscheduler.v1beta1.json | 4 +- .../documents/contactcenterinsights.v1.json | 4 +- .../documents/dataform.v1.json | 6 +- .../documents/dataform.v1beta1.json | 10 +- .../documents/documentai.v1.json | 26 +- .../documents/documentai.v1beta3.json | 20 +- .../discovery_cache/documents/iam.v1.json | 10 +- .../documents/kmsinventory.v1.json | 14 +- .../documents/merchantapi.accounts_v1.json | 8 +- .../merchantapi.accounts_v1beta.json | 8 +- .../merchantapi.ordertracking_v1.json | 5 +- .../documents/saasservicemgmt.v1beta1.json | 12 +- .../documents/servicedirectory.v1.json | 4 +- .../documents/servicedirectory.v1beta1.json | 4 +- .../discovery_cache/documents/sheets.v4.json | 50 +- .../documents/vmmigration.v1alpha1.json | 38 +- .../documents/walletobjects.v1.json | 5 +- 60 files changed, 598 insertions(+), 514 deletions(-) diff --git a/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html b/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html index 0c8e0ae5787..6d2d00b7a75 100644 --- a/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html +++ b/docs/dyn/alloydb_v1.projects.locations.clusters.instances.html @@ -166,7 +166,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -323,7 +323,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -571,7 +571,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -775,7 +775,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -921,7 +921,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. diff --git a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html index 7fac1fc332b..a00f2a8d032 100644 --- a/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html +++ b/docs/dyn/alloydb_v1alpha.projects.locations.clusters.instances.html @@ -172,7 +172,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -362,7 +362,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -643,7 +643,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -884,7 +884,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -1063,7 +1063,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. diff --git a/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html b/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html index 3644aa09d7b..ec0f539ca99 100644 --- a/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html +++ b/docs/dyn/alloydb_v1beta.projects.locations.clusters.instances.html @@ -172,7 +172,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -361,7 +361,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -641,7 +641,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -881,7 +881,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. @@ -1059,7 +1059,7 @@

Method Details

"maintenanceVersionName": "A String", # Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s). "name": "A String", # Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} "networkConfig": { # Metadata related to instance-level network configuration. # Optional. Instance-level network configuration. - "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. + "allocatedIpRangeOverride": "A String", # Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. "authorizedExternalNetworks": [ # Optional. A list of external network authorized to access this instance. { # AuthorizedNetwork contains metadata for an authorized network. "cidrRange": "A String", # CIDR range for one authorzied network of the instance. diff --git a/docs/dyn/androidmanagement_v1.enterprises.html b/docs/dyn/androidmanagement_v1.enterprises.html index 8179f9a8d4c..013960599bb 100644 --- a/docs/dyn/androidmanagement_v1.enterprises.html +++ b/docs/dyn/androidmanagement_v1.enterprises.html @@ -164,7 +164,7 @@

Method Details

"enterpriseDisplayName": "A String", # The name of the enterprise displayed to users. This field has a maximum length of 100 characters. "enterpriseType": "A String", # Output only. The type of the enterprise. "googleAuthenticationSettings": { # Contains settings for Google-provided user authentication. # Settings for Google-provided user authentication. - "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. + "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set. }, "logo": { # Data hosted at an external location. The data is to be downloaded by Android Device Policy and verified against the hash. # An image displayed as a logo during device provisioning. Supported types are: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. "sha256Hash": "A String", # The base-64 encoded SHA-256 hash of the content hosted at url. If the content doesn't match this hash, Android Device Policy won't use the data. @@ -232,7 +232,7 @@

Method Details

"enterpriseDisplayName": "A String", # The name of the enterprise displayed to users. This field has a maximum length of 100 characters. "enterpriseType": "A String", # Output only. The type of the enterprise. "googleAuthenticationSettings": { # Contains settings for Google-provided user authentication. # Settings for Google-provided user authentication. - "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. + "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set. }, "logo": { # Data hosted at an external location. The data is to be downloaded by Android Device Policy and verified against the hash. # An image displayed as a logo during device provisioning. Supported types are: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. "sha256Hash": "A String", # The base-64 encoded SHA-256 hash of the content hosted at url. If the content doesn't match this hash, Android Device Policy won't use the data. @@ -350,7 +350,7 @@

Method Details

"enterpriseDisplayName": "A String", # The name of the enterprise displayed to users. This field has a maximum length of 100 characters. "enterpriseType": "A String", # Output only. The type of the enterprise. "googleAuthenticationSettings": { # Contains settings for Google-provided user authentication. # Settings for Google-provided user authentication. - "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. + "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set. }, "logo": { # Data hosted at an external location. The data is to be downloaded by Android Device Policy and verified against the hash. # An image displayed as a logo during device provisioning. Supported types are: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. "sha256Hash": "A String", # The base-64 encoded SHA-256 hash of the content hosted at url. If the content doesn't match this hash, Android Device Policy won't use the data. @@ -429,7 +429,7 @@

Method Details

"enterpriseDisplayName": "A String", # The name of the enterprise displayed to users. This field has a maximum length of 100 characters. "enterpriseType": "A String", # Output only. The type of the enterprise. "googleAuthenticationSettings": { # Contains settings for Google-provided user authentication. # Settings for Google-provided user authentication. - "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. + "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set. }, "logo": { # Data hosted at an external location. The data is to be downloaded by Android Device Policy and verified against the hash. # An image displayed as a logo during device provisioning. Supported types are: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. "sha256Hash": "A String", # The base-64 encoded SHA-256 hash of the content hosted at url. If the content doesn't match this hash, Android Device Policy won't use the data. @@ -512,7 +512,7 @@

Method Details

"enterpriseDisplayName": "A String", # The name of the enterprise displayed to users. This field has a maximum length of 100 characters. "enterpriseType": "A String", # Output only. The type of the enterprise. "googleAuthenticationSettings": { # Contains settings for Google-provided user authentication. # Settings for Google-provided user authentication. - "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. + "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set. }, "logo": { # Data hosted at an external location. The data is to be downloaded by Android Device Policy and verified against the hash. # An image displayed as a logo during device provisioning. Supported types are: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. "sha256Hash": "A String", # The base-64 encoded SHA-256 hash of the content hosted at url. If the content doesn't match this hash, Android Device Policy won't use the data. @@ -577,7 +577,7 @@

Method Details

"enterpriseDisplayName": "A String", # The name of the enterprise displayed to users. This field has a maximum length of 100 characters. "enterpriseType": "A String", # Output only. The type of the enterprise. "googleAuthenticationSettings": { # Contains settings for Google-provided user authentication. # Settings for Google-provided user authentication. - "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. + "googleAuthenticationRequired": "A String", # Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set. }, "logo": { # Data hosted at an external location. The data is to be downloaded by Android Device Policy and verified against the hash. # An image displayed as a logo during device provisioning. Supported types are: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. "sha256Hash": "A String", # The base-64 encoded SHA-256 hash of the content hosted at url. If the content doesn't match this hash, Android Device Policy won't use the data. diff --git a/docs/dyn/apphub_v1.projects.locations.html b/docs/dyn/apphub_v1.projects.locations.html index de327e9c846..5a51437375e 100644 --- a/docs/dyn/apphub_v1.projects.locations.html +++ b/docs/dyn/apphub_v1.projects.locations.html @@ -118,7 +118,7 @@

Instance Methods

Gets a Boundary.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -210,7 +210,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/apphub_v1alpha.projects.locations.html b/docs/dyn/apphub_v1alpha.projects.locations.html
index 57b3b9beef5..63ce8ef065e 100644
--- a/docs/dyn/apphub_v1alpha.projects.locations.html
+++ b/docs/dyn/apphub_v1alpha.projects.locations.html
@@ -118,7 +118,7 @@ 

Instance Methods

Gets a Boundary.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -210,7 +210,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/calendar_v3.events.html b/docs/dyn/calendar_v3.events.html
index 66215fbf45a..8f1e38099a9 100644
--- a/docs/dyn/calendar_v3.events.html
+++ b/docs/dyn/calendar_v3.events.html
@@ -201,7 +201,7 @@ 

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -508,7 +508,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -810,7 +810,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -1116,7 +1116,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -1427,7 +1427,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -1765,7 +1765,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -2169,7 +2169,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -2508,7 +2508,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -2815,7 +2815,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -3127,7 +3127,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -3443,7 +3443,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -3750,7 +3750,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: @@ -4062,7 +4062,7 @@

Method Details

# - "self" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type "birthday". The type cannot be changed after the event is created. }, "colorId": "A String", # The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional. - "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. + "conferenceData": { # The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field. "conferenceId": "A String", # The ID of the conference. # Can be used by developers to keep track of conferences, should not be displayed to users. # The ID value is formed differently for each conference solution type: diff --git a/docs/dyn/cloudscheduler_v1.projects.locations.html b/docs/dyn/cloudscheduler_v1.projects.locations.html index 2fca1eace6e..f6368c086dc 100644 --- a/docs/dyn/cloudscheduler_v1.projects.locations.html +++ b/docs/dyn/cloudscheduler_v1.projects.locations.html @@ -95,7 +95,7 @@

Instance Methods

Gets the Scheduler config in the project/region.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -157,7 +157,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/cloudscheduler_v1beta1.projects.locations.html b/docs/dyn/cloudscheduler_v1beta1.projects.locations.html
index d645fadd62b..301adee1c80 100644
--- a/docs/dyn/cloudscheduler_v1beta1.projects.locations.html
+++ b/docs/dyn/cloudscheduler_v1beta1.projects.locations.html
@@ -92,7 +92,7 @@ 

Instance Methods

Gets information about a location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -131,7 +131,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html b/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html
index 1b5a92a4fc2..99390523dff 100644
--- a/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html
+++ b/docs/dyn/contactcenterinsights_v1.projects.locations.dashboards.html
@@ -785,7 +785,7 @@ 

Method Details

"updateTime": "A String", # Output only. Dashboard last update time. } - updateMask: string, Optional. List of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `display_name` * `root_container` + updateMask: string, Optional. List of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `display_name` * `root_container` * `description` x__xgafv: string, V1 error format. Allowed values 1 - v1 error format diff --git a/docs/dyn/dataform_v1.projects.locations.html b/docs/dyn/dataform_v1.projects.locations.html index d59a59546e4..5178f60e2b6 100644 --- a/docs/dyn/dataform_v1.projects.locations.html +++ b/docs/dyn/dataform_v1.projects.locations.html @@ -105,7 +105,7 @@

Instance Methods

Get default config for a given project and location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -168,7 +168,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/dataform_v1.projects.locations.repositories.compilationResults.html b/docs/dyn/dataform_v1.projects.locations.repositories.compilationResults.html
index c2dcb1a6ab8..a9747f15115 100644
--- a/docs/dyn/dataform_v1.projects.locations.repositories.compilationResults.html
+++ b/docs/dyn/dataform_v1.projects.locations.repositories.compilationResults.html
@@ -533,7 +533,7 @@ 

Method Details

"clusterExpressions": [ # A list of columns or SQL expressions used to cluster the table. "A String", ], - "connection": "A String", # Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}", or be set to DEFAULT. + "connection": "A String", # Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}`, or be set to DEFAULT. "dependencyTargets": [ # A list of actions that this action depends on. { # Represents an action identifier. If the action writes output, the output will be written to the referenced database object. "database": "A String", # Optional. The action's database (Google Cloud project ID) . diff --git a/docs/dyn/dataform_v1beta1.projects.locations.folders.html b/docs/dyn/dataform_v1beta1.projects.locations.folders.html index 598f4399f53..9625ba01cc8 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.folders.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.folders.html @@ -243,7 +243,7 @@

Method Details

The object takes the form of: { # `MoveFolder` request message. - "destinationContainingFolder": "A String", # Required. The name of the Folder, TeamFolder, or root location to move the Folder to. Can be in the format of: - "" to move into the root User folder - `projects/*/locations/*/folders/*` - `projects/*/locations/*/teamFolders/*` + "destinationContainingFolder": "A String", # Optional. The name of the Folder, TeamFolder, or root location to move the Folder to. Can be in the format of: "" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*` } x__xgafv: string, V1 error format. diff --git a/docs/dyn/dataform_v1beta1.projects.locations.html b/docs/dyn/dataform_v1beta1.projects.locations.html index 99603daf6e5..18ddd7d593e 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.html @@ -105,7 +105,7 @@

Instance Methods

Get default config for a given project and location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -174,7 +174,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.compilationResults.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.compilationResults.html
index c1cb98a1ba3..1ca41c17740 100644
--- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.compilationResults.html
+++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.compilationResults.html
@@ -533,7 +533,7 @@ 

Method Details

"clusterExpressions": [ # A list of columns or SQL expressions used to cluster the table. "A String", ], - "connection": "A String", # Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}", or be set to DEFAULT. + "connection": "A String", # Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}`, or be set to DEFAULT. "dependencyTargets": [ # A list of actions that this action depends on. { # Represents an action identifier. If the action writes output, the output will be written to the referenced database object. "database": "A String", # Optional. The action's database (Google Cloud project ID) . diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html index 4661d417c5b..dc87128e0e7 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html @@ -565,7 +565,7 @@

Method Details

The object takes the form of: { # `MoveRepository` request message. - "destinationContainingFolder": "A String", # Required. The name of the Folder, TeamFolder, or root location to move the repository to. Can be in the format of: - "" to move into the root User folder - `projects/*/locations/*/folders/*` - `projects/*/locations/*/teamFolders/*` + "destinationContainingFolder": "A String", # Optional. The name of the Folder, TeamFolder, or root location to move the repository to. Can be in the format of: "" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*` } x__xgafv: string, V1 error format. diff --git a/docs/dyn/kmsinventory_v1.organizations.protectedResources.html b/docs/dyn/kmsinventory_v1.organizations.protectedResources.html index a27c8e653d4..ccec9a8d53e 100644 --- a/docs/dyn/kmsinventory_v1.organizations.protectedResources.html +++ b/docs/dyn/kmsinventory_v1.organizations.protectedResources.html @@ -94,7 +94,7 @@

Method Details

Returns metadata about the resources protected by the given Cloud KMS CryptoKey in the given Cloud organization/project.
 
 Args:
-  scope: string, Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The allowed values are: * organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/12345678") * projects/{PROJECT_ID} (e.g., "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., "projects/12345678") (required)
+  scope: string, Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The following values are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/12345678") * projects/{PROJECT_ID} (e.g., "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., "projects/12345678") (required)
   cryptoKey: string, Required. The resource name of the CryptoKey.
   pageSize: integer, The maximum number of resources to return. The service may return fewer than this value. If unspecified, at most 500 resources will be returned. The maximum value is 500; values above 500 will be coerced to 500.
   pageToken: string, A page token, received from a previous KeyTrackingService.SearchProtectedResources call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to KeyTrackingService.SearchProtectedResources must match the call that provided the page token.
diff --git a/docs/dyn/kmsinventory_v1.projects.locations.keyRings.cryptoKeys.html b/docs/dyn/kmsinventory_v1.projects.locations.keyRings.cryptoKeys.html
index c7c0923abbb..18c70217293 100644
--- a/docs/dyn/kmsinventory_v1.projects.locations.keyRings.cryptoKeys.html
+++ b/docs/dyn/kmsinventory_v1.projects.locations.keyRings.cryptoKeys.html
@@ -118,7 +118,7 @@ 

Method Details

"a_key": "A String", }, "warnings": [ # Warning messages for the state of response ProtectedResourcesSummary For example, if the organization service account is not configured, INSUFFICIENT_PERMISSIONS_PARTIAL_DATA warning will be returned. - { # Warning message specifying various states of response data that might indicate incomplete or partial results. + { # A warning message that indicates potential problems with the response data. "displayMessage": "A String", # The literal message providing context and details about the warnings. "warningCode": "A String", # The specific warning code for the displayed message. }, diff --git a/docs/dyn/kmsinventory_v1.projects.protectedResources.html b/docs/dyn/kmsinventory_v1.projects.protectedResources.html index 185b765bcb1..0452e8bbc4e 100644 --- a/docs/dyn/kmsinventory_v1.projects.protectedResources.html +++ b/docs/dyn/kmsinventory_v1.projects.protectedResources.html @@ -94,7 +94,7 @@

Method Details

Returns metadata about the resources protected by the given Cloud KMS CryptoKey in the given Cloud organization/project.
 
 Args:
-  scope: string, Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The allowed values are: * organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/12345678") * projects/{PROJECT_ID} (e.g., "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., "projects/12345678") (required)
+  scope: string, Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The following values are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/12345678") * projects/{PROJECT_ID} (e.g., "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., "projects/12345678") (required)
   cryptoKey: string, Required. The resource name of the CryptoKey.
   pageSize: integer, The maximum number of resources to return. The service may return fewer than this value. If unspecified, at most 500 resources will be returned. The maximum value is 500; values above 500 will be coerced to 500.
   pageToken: string, A page token, received from a previous KeyTrackingService.SearchProtectedResources call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to KeyTrackingService.SearchProtectedResources must match the call that provided the page token.
diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.html b/docs/dyn/merchantapi_accounts_v1.accounts.html
index 66e7c26a986..ce9f5638699 100644
--- a/docs/dyn/merchantapi_accounts_v1.accounts.html
+++ b/docs/dyn/merchantapi_accounts_v1.accounts.html
@@ -208,7 +208,7 @@ 

Method Details

{ # Request message for the `CreateAndConfigureAccount` method. "account": { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. # Required. The account to be created. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -267,7 +267,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -314,7 +314,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -346,7 +346,7 @@

Method Details

"accounts": [ # The accounts matching the `ListAccountsRequest`. { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -381,7 +381,7 @@

Method Details

"accounts": [ # The accounts for which the given parent account is an aggregator. { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -435,7 +435,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -457,7 +457,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html b/docs/dyn/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html index 93e66456e84..e726ffa98ac 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.programs.checkoutSettings.html @@ -111,7 +111,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -138,7 +138,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -190,7 +190,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -219,7 +219,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -247,7 +247,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. diff --git a/docs/dyn/merchantapi_accounts_v1.accounts.programs.html b/docs/dyn/merchantapi_accounts_v1.accounts.programs.html index 5422a831867..0b06f6c7f83 100644 --- a/docs/dyn/merchantapi_accounts_v1.accounts.programs.html +++ b/docs/dyn/merchantapi_accounts_v1.accounts.programs.html @@ -123,7 +123,7 @@

Method Details

Returns: An object of the form: - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], @@ -162,7 +162,7 @@

Method Details

Returns: An object of the form: - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], @@ -195,7 +195,7 @@

Method Details

Returns: An object of the form: - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], @@ -233,7 +233,7 @@

Method Details

{ # Response message for the ListPrograms method. "nextPageToken": "A String", # A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. "programs": [ # The programs for the given account. - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.html index e12f9d95a7b..7dd9b000372 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.html @@ -208,7 +208,7 @@

Method Details

{ # Request message for the `CreateAndConfigureAccount` method. "account": { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. # Required. The account to be created. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -280,7 +280,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -327,7 +327,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -359,7 +359,7 @@

Method Details

"accounts": [ # The accounts matching the `ListAccountsRequest`. { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -394,7 +394,7 @@

Method Details

"accounts": [ # The accounts for which the given parent account is an aggregator. { # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -448,7 +448,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` @@ -470,7 +470,7 @@

Method Details

{ # The `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on. "accountId": "A String", # Output only. The ID of the account. - "accountName": "A String", # Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. + "accountName": "A String", # Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information. "adultContent": True or False, # Optional. Whether this account contains adult content. "languageCode": "A String", # Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. "name": "A String", # Identifier. The resource name of the account. Format: `accounts/{account}` diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.checkoutSettings.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.checkoutSettings.html index a72c577cb60..b63796bf0e3 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.checkoutSettings.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.checkoutSettings.html @@ -111,7 +111,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -138,7 +138,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -190,7 +190,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -219,7 +219,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. @@ -247,7 +247,7 @@

Method Details

"cartUriTemplate": "A String", # Cart URL template. When the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) "checkoutUriTemplate": "A String", # Checkout URL template. When the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart. For more details, check the [help center doc](https://support.google.com/merchants/answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-url-formatting) }, - "eligibleDestinations": [ # Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS` + "eligibleDestinations": [ # Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`. "A String", ], "enrollmentState": "A String", # Output only. Reflects the merchant enrollment state in `Checkout` program. diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html index a683d6832ec..280e094f79d 100644 --- a/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html +++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.programs.html @@ -123,7 +123,7 @@

Method Details

Returns: An object of the form: - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], @@ -162,7 +162,7 @@

Method Details

Returns: An object of the form: - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], @@ -195,7 +195,7 @@

Method Details

Returns: An object of the form: - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], @@ -233,7 +233,7 @@

Method Details

{ # Response message for the ListPrograms method. "nextPageToken": "A String", # A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. "programs": [ # The programs for the given account. - { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout` + { # Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout` "activeRegionCodes": [ # Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. "A String", ], diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html index c9c34be517f..763acf05cdc 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitOperations.html @@ -110,7 +110,7 @@

Method Details

body: object, The request body. The object takes the form of: -{ # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19 +{ # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22 "annotations": { # Optional. Annotations is an 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. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, @@ -177,7 +177,7 @@

Method Details

Returns: An object of the form: - { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19 + { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22 "annotations": { # Optional. Annotations is an 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. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, @@ -269,7 +269,7 @@

Method Details

Returns: An object of the form: - { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19 + { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22 "annotations": { # Optional. Annotations is an 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. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, @@ -347,7 +347,7 @@

Method Details

{ # The response structure for the ListUnitOperations method. "nextPageToken": "A String", # If present, the next page token can be provided to a subsequent ListUnitOperations call to list the next page. If empty, there are no more pages. "unitOperations": [ # The resulting unit operations. - { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19 + { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22 "annotations": { # Optional. Annotations is an 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. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, @@ -432,7 +432,7 @@

Method Details

body: object, The request body. The object takes the form of: -{ # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19 +{ # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22 "annotations": { # Optional. Annotations is an 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. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, @@ -499,7 +499,7 @@

Method Details

Returns: An object of the form: - { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19 + { # UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22 "annotations": { # Optional. Annotations is an 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. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, diff --git a/docs/dyn/servicedirectory_v1.projects.locations.html b/docs/dyn/servicedirectory_v1.projects.locations.html index 4a32641b3d1..1e086d2fa44 100644 --- a/docs/dyn/servicedirectory_v1.projects.locations.html +++ b/docs/dyn/servicedirectory_v1.projects.locations.html @@ -87,7 +87,7 @@

Instance Methods

Gets information about a location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -126,7 +126,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/servicedirectory_v1beta1.projects.locations.html b/docs/dyn/servicedirectory_v1beta1.projects.locations.html
index bd19abd5fae..6a2dbdf85ef 100644
--- a/docs/dyn/servicedirectory_v1beta1.projects.locations.html
+++ b/docs/dyn/servicedirectory_v1beta1.projects.locations.html
@@ -87,7 +87,7 @@ 

Instance Methods

Gets information about a location.

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

-

Lists information about the supported locations for this service.

+

Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.

list_next()

Retrieves the next page of results.

@@ -126,7 +126,7 @@

Method Details

list(name, extraLocationTypes=None, filter=None, pageSize=None, pageToken=None, x__xgafv=None) -
Lists information about the supported locations for this service.
+  
Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.
 
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
diff --git a/docs/dyn/sheets_v4.spreadsheets.developerMetadata.html b/docs/dyn/sheets_v4.spreadsheets.developerMetadata.html
index 91949e4367e..93b9482a75c 100644
--- a/docs/dyn/sheets_v4.spreadsheets.developerMetadata.html
+++ b/docs/dyn/sheets_v4.spreadsheets.developerMetadata.html
@@ -79,10 +79,10 @@ 

Instance Methods

Close httplib2 connections.

get(spreadsheetId, metadataId, x__xgafv=None)

-

Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId.

+

Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata).

search(spreadsheetId, body=None, x__xgafv=None)

-

Returns all developer metadata matching the specified DataFilter. If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.

+

Returns all developer metadata matching the specified DataFilter. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.

Method Details

close() @@ -91,7 +91,7 @@

Method Details

get(spreadsheetId, metadataId, x__xgafv=None) -
Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId.
+  
Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata).
 
 Args:
   spreadsheetId: string, The ID of the spreadsheet to retrieve metadata from. (required)
@@ -104,9 +104,9 @@ 

Method Details

Returns: An object of the form: - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -119,13 +119,13 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }
search(spreadsheetId, body=None, x__xgafv=None) -
Returns all developer metadata matching the specified DataFilter. If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.
+  
Returns all developer metadata matching the specified DataFilter. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.
 
 Args:
   spreadsheetId: string, The ID of the spreadsheet to retrieve metadata from. (required)
@@ -134,15 +134,15 @@ 

Method Details

{ # A request to retrieve all developer metadata matching the set of specified criteria. "dataFilters": [ # The data filters describing the criteria used to determine which DeveloperMetadata entries to return. DeveloperMetadata matching any of the specified filters are included in the response. - { # Filter that describes what data should be selected or returned from a request. + { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -178,15 +178,15 @@

Method Details

"matchedDeveloperMetadata": [ # The metadata matching the criteria of the search request. { # A developer metadata entry and the data filters specified in the original request that matched it. "dataFilters": [ # All filters matching the returned developer metadata. - { # Filter that describes what data should be selected or returned from a request. + { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -208,9 +208,9 @@

Method Details

}, }, ], - "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. # The developer metadata matching the specified filters. + "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. # The developer metadata matching the specified filters. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -223,7 +223,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, }, ], diff --git a/docs/dyn/sheets_v4.spreadsheets.html b/docs/dyn/sheets_v4.spreadsheets.html index 8b2e220ebc2..2adecbff73b 100644 --- a/docs/dyn/sheets_v4.spreadsheets.html +++ b/docs/dyn/sheets_v4.spreadsheets.html @@ -103,7 +103,7 @@

Instance Methods

Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. By default, data within grids is not returned. You can include grid data in one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want. To retrieve only subsets of spreadsheet data, use the ranges URL parameter. Ranges are specified using [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). You can define a single cell (for example, `A1`) or multiple cells (for example, `A1:D5`). You can also get cells from other sheets within the same spreadsheet (for example, `Sheet2!A1:C4`) or retrieve multiple ranges at once (for example, `?ranges=A1:D5&ranges=Sheet2!A1:C4`). Limiting the range returns only the portions of the spreadsheet that intersect the requested ranges.

getByDataFilter(spreadsheetId, body=None, x__xgafv=None)

-

Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.

+

Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data in one of two ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP. * Set the includeGridData parameter to `true`. If a field mask is set, the `includeGridData` parameter is ignored. For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.

Method Details

batchUpdate(spreadsheetId, body=None, x__xgafv=None) @@ -932,8 +932,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -2207,10 +2207,10 @@

Method Details

}, }, "addFilterView": { # Adds a filter view. # Adds a filter view. - "filter": { # A filter view. # The filter to add. The filterViewId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a filter that already exists.) + "filter": { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The filter to add. The filterViewId field is optional. If one is not set, an ID will be randomly generated. (It is an error to specify the ID of a filter that already exists.) "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -2254,14 +2254,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -2307,8 +2307,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -2354,7 +2354,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, }, @@ -2500,8 +2500,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -2694,8 +2694,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -3464,9 +3464,9 @@

Method Details

}, }, "createDeveloperMetadata": { # A request to create developer metadata. # Creates new developer metadata - "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. # The developer metadata to create. + "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. # The developer metadata to create. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -3479,7 +3479,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, }, "cutPaste": { # Moves data from the source to the destination. # Cuts data from one area and pastes it to another. @@ -3508,15 +3508,15 @@

Method Details

"dataSourceId": "A String", # The ID of the data source to delete. }, "deleteDeveloperMetadata": { # A request to delete developer metadata. # Deletes developer metadata - "dataFilter": { # Filter that describes what data should be selected or returned from a request. # The data filter describing the criteria used to select which developer metadata entry to delete. + "dataFilter": { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). # The data filter describing the criteria used to select which developer metadata entry to delete. "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -3757,8 +3757,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -4440,10 +4440,10 @@

Method Details

}, }, "setBasicFilter": { # Sets the basic filter associated with a sheet. # Sets the basic filter on a sheet. - "filter": { # The default filter associated with a sheet. # The filter to set. + "filter": { # The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The filter to set. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -4493,8 +4493,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -5007,8 +5007,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -6333,8 +6333,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -7603,15 +7603,15 @@

Method Details

}, "updateDeveloperMetadata": { # A request to update properties of developer metadata. Updates the properties of the developer metadata selected by the filters to the values provided in the DeveloperMetadata resource. Callers must specify the properties they wish to update in the fields parameter, as well as specify at least one DataFilter matching the metadata they wish to update. # Updates an existing developer metadata entry "dataFilters": [ # The filters matching the developer metadata entries to update. - { # Filter that describes what data should be selected or returned from a request. + { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -7633,9 +7633,9 @@

Method Details

}, }, ], - "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. # The value that all metadata matched by the data filters will be updated to. + "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. # The value that all metadata matched by the data filters will be updated to. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -7648,7 +7648,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, "fields": "A String", # The fields that should be updated. At least one field must be specified. The root `developerMetadata` is implied and should not be specified. A single `"*"` can be used as short-hand for listing every field. }, @@ -7680,9 +7680,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -7695,7 +7695,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -7751,10 +7751,10 @@

Method Details

}, "updateFilterView": { # Updates properties of the filter view. # Updates the properties of a filter view. "fields": "A String", # The fields that should be updated. At least one field must be specified. The root `filter` is implied and should not be specified. A single `"*"` can be used as short-hand for listing every field. - "filter": { # A filter view. # The new properties of the filter view. + "filter": { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The new properties of the filter view. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -7798,14 +7798,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -7851,8 +7851,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -7898,7 +7898,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, }, @@ -8032,8 +8032,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -9180,8 +9180,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -10243,10 +10243,10 @@

Method Details

], }, "addFilterView": { # The result of adding a filter view. # A reply from adding a filter view. - "filter": { # A filter view. # The newly added filter view. + "filter": { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The newly added filter view. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -10290,14 +10290,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -10343,8 +10343,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -10390,7 +10390,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, }, @@ -10536,8 +10536,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -10710,9 +10710,9 @@

Method Details

], }, "createDeveloperMetadata": { # The response from creating developer metadata. # A reply from creating a developer metadata entry. - "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. # The developer metadata that was created. + "developerMetadata": { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. # The developer metadata that was created. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -10725,7 +10725,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, }, "deleteConditionalFormatRule": { # The result of deleting a conditional format rule. # A reply from deleting a conditional format rule. @@ -10953,9 +10953,9 @@

Method Details

}, "deleteDeveloperMetadata": { # The response from deleting developer metadata. # A reply from deleting a developer metadata entry. "deletedDeveloperMetadata": [ # The metadata that was deleted. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -10968,7 +10968,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], }, @@ -10990,10 +10990,10 @@

Method Details

"duplicatesRemovedCount": 42, # The number of duplicate rows removed. }, "duplicateFilterView": { # The result of a filter view being duplicated. # A reply from duplicating a filter view. - "filter": { # A filter view. # The newly created filter. + "filter": { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The newly created filter. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -11037,14 +11037,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -11090,8 +11090,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -11137,7 +11137,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, }, @@ -11732,9 +11732,9 @@

Method Details

}, "updateDeveloperMetadata": { # The response from updating developer metadata. # A reply from updating a developer metadata entry. "developerMetadata": [ # The updated developer metadata. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -11747,7 +11747,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], }, @@ -11858,9 +11858,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a spreadsheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -11873,7 +11873,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "namedRanges": [ # The named ranges defined in a spreadsheet. @@ -12196,10 +12196,10 @@

Method Details

}, }, ], - "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any. + "basicFilter": { # The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The filter on this sheet, if any. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -12249,8 +12249,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -13020,8 +13020,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -14260,9 +14260,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -14275,7 +14275,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -14331,8 +14331,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -15013,9 +15013,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -15028,7 +15028,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -15041,9 +15041,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a sheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -15056,14 +15056,14 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "filterViews": [ # The filter views in this sheet. - { # A filter view. + { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -15107,14 +15107,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -15160,8 +15160,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -15207,7 +15207,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, ], @@ -15359,8 +15359,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -15611,9 +15611,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a spreadsheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -15626,7 +15626,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "namedRanges": [ # The named ranges defined in a spreadsheet. @@ -15949,10 +15949,10 @@

Method Details

}, }, ], - "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any. + "basicFilter": { # The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The filter on this sheet, if any. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -16002,8 +16002,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -16773,8 +16773,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -18013,9 +18013,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -18028,7 +18028,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -18084,8 +18084,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -18766,9 +18766,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -18781,7 +18781,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -18794,9 +18794,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a sheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -18809,14 +18809,14 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "filterViews": [ # The filter views in this sheet. - { # A filter view. + { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -18860,14 +18860,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -18913,8 +18913,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -18960,7 +18960,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, ], @@ -19112,8 +19112,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -19357,9 +19357,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a spreadsheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -19372,7 +19372,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "namedRanges": [ # The named ranges defined in a spreadsheet. @@ -19695,10 +19695,10 @@

Method Details

}, }, ], - "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any. + "basicFilter": { # The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The filter on this sheet, if any. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -19748,8 +19748,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -20519,8 +20519,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -21759,9 +21759,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -21774,7 +21774,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -21830,8 +21830,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -22512,9 +22512,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -22527,7 +22527,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -22540,9 +22540,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a sheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -22555,14 +22555,14 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "filterViews": [ # The filter views in this sheet. - { # A filter view. + { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -22606,14 +22606,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -22659,8 +22659,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -22706,7 +22706,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, ], @@ -22858,8 +22858,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -23113,9 +23113,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a spreadsheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -23128,7 +23128,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "namedRanges": [ # The named ranges defined in a spreadsheet. @@ -23451,10 +23451,10 @@

Method Details

}, }, ], - "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any. + "basicFilter": { # The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The filter on this sheet, if any. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -23504,8 +23504,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -24275,8 +24275,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -25515,9 +25515,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -25530,7 +25530,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -25586,8 +25586,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -26268,9 +26268,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -26283,7 +26283,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -26296,9 +26296,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a sheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -26311,14 +26311,14 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "filterViews": [ # The filter views in this sheet. - { # A filter view. + { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -26362,14 +26362,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -26415,8 +26415,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -26462,7 +26462,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, ], @@ -26614,8 +26614,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -26767,7 +26767,7 @@

Method Details

getByDataFilter(spreadsheetId, body=None, x__xgafv=None) -
Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.
+  
Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data in one of two ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP. * Set the includeGridData parameter to `true`. If a field mask is set, the `includeGridData` parameter is ignored. For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.
 
 Args:
   spreadsheetId: string, The spreadsheet to request. (required)
@@ -26776,15 +26776,15 @@ 

Method Details

{ # The request for retrieving a Spreadsheet. "dataFilters": [ # The DataFilters used to select which ranges to retrieve from the spreadsheet. - { # Filter that describes what data should be selected or returned from a request. + { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -26905,9 +26905,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a spreadsheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -26920,7 +26920,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "namedRanges": [ # The named ranges defined in a spreadsheet. @@ -27243,10 +27243,10 @@

Method Details

}, }, ], - "basicFilter": { # The default filter associated with a sheet. # The filter on this sheet, if any. + "basicFilter": { # The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). # The filter on this sheet, if any. "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -27296,8 +27296,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -28067,8 +28067,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -29307,9 +29307,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -29322,7 +29322,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -29378,8 +29378,8 @@

Method Details

"dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -30060,9 +30060,9 @@

Method Details

"name": "A String", # The display name of the column. It should be unique within a data source. }, "developerMetadata": [ # The developer metadata associated with a single row or column. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -30075,7 +30075,7 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "hiddenByFilter": True or False, # True if this dimension is being filtered. This field is read-only. @@ -30088,9 +30088,9 @@

Method Details

}, ], "developerMetadata": [ # The developer metadata associated with a sheet. - { # Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too. + { # Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too. "location": { # A location where metadata may be associated in a spreadsheet. # The location where the metadata is associated. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -30103,14 +30103,14 @@

Method Details

"metadataId": 42, # The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be positive. "metadataKey": "A String", # The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. "metadataValue": "A String", # Data associated with the metadata's key. - "visibility": "A String", # The metadata visibility. Developer metadata must always have a visibility specified. + "visibility": "A String", # The metadata visibility. Developer metadata must always have visibility specified. }, ], "filterViews": [ # The filter views in this sheet. - { # A filter view. + { # A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters). "criteria": { # The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of filter_specs. - "a_key": { # Criteria for showing/hiding rows in a filter or filter view. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "a_key": { # Criteria for showing or hiding rows in a filter or filter view. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -30154,14 +30154,14 @@

Method Details

}, }, }, - "filterSpecs": [ # The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. + "filterSpecs": [ # The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. { # The filter criteria associated with a specific column. "columnIndex": 42, # The zero-based column index. "dataSourceColumnReference": { # An unique identifier that references a data source column. # Reference to a data source column. "name": "A String", # The display name of the column. It should be unique within a data source. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The criteria for the column. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The criteria for the column. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. @@ -30207,8 +30207,8 @@

Method Details

}, ], "filterViewId": 42, # The ID of the filter view. - "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. - "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set. + "namedRangeId": "A String", # The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. + "range": { # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e. the start index is inclusive and the end index is exclusive -- [start_index, end_index). Missing indexes indicate the range is unbounded on that side. For example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id: 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0, end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2, end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B == sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B == sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or equal to the end index. If the start index equals the end index, then the range is empty. Empty ranges are typically not meaningful and are usually rendered in the UI as `#REF!`. # The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set. "endColumnIndex": 42, # The end column (exclusive) of the range, or not set if unbounded. "endRowIndex": 42, # The end row (exclusive) of the range, or not set if unbounded. "sheetId": 42, # The sheet this range is on. @@ -30254,7 +30254,7 @@

Method Details

"sortOrder": "A String", # The order data should be sorted. }, ], - "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set. + "tableId": "A String", # The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set. "title": "A String", # The name of the filter view. }, ], @@ -30406,8 +30406,8 @@

Method Details

"startColumnIndex": 42, # The start column (inclusive) of the range, or not set if unbounded. "startRowIndex": 42, # The start row (inclusive) of the range, or not set if unbounded. }, - "filterCriteria": { # Criteria for showing/hiding rows in a filter or filter view. # The filtering criteria of the slicer. - "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) + "filterCriteria": { # Criteria for showing or hiding rows in a filter or filter view. # The filtering criteria of the slicer. + "condition": { # A condition that can evaluate to true or false. BooleanConditions are used by conditional formatting, data validation, and the criteria in filters. # A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) "type": "A String", # The type of condition. "values": [ # The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports an arbitrary number of values. { # The value of the condition. diff --git a/docs/dyn/sheets_v4.spreadsheets.values.html b/docs/dyn/sheets_v4.spreadsheets.values.html index b11a4f0d61b..4ee0933c0e2 100644 --- a/docs/dyn/sheets_v4.spreadsheets.values.html +++ b/docs/dyn/sheets_v4.spreadsheets.values.html @@ -82,19 +82,19 @@

Instance Methods

Clears one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more ranges. Only values are cleared -- all other properties of the cell (such as formatting and data validation) are kept.

batchClearByDataFilter(spreadsheetId, body=None, x__xgafv=None)

-

Clears one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.

+

Clears one or more ranges of values from a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc.) are kept.

batchGet(spreadsheetId, dateTimeRenderOption=None, majorDimension=None, ranges=None, valueRenderOption=None, x__xgafv=None)

Returns one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more ranges.

batchGetByDataFilter(spreadsheetId, body=None, x__xgafv=None)

-

Returns one or more ranges of values that match the specified data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.

+

Returns one or more ranges of values that match the specified data filters. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.

batchUpdate(spreadsheetId, body=None, x__xgafv=None)

Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more ValueRanges.

batchUpdateByDataFilter(spreadsheetId, body=None, x__xgafv=None)

-

Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.

+

Sets values in one or more ranges of a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.

clear(spreadsheetId, range, body=None, x__xgafv=None)

Clears values from a spreadsheet. The caller must specify the spreadsheet ID and range. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.

@@ -201,7 +201,7 @@

Method Details

An object of the form: { # The response when clearing a range of values in a spreadsheet. - "clearedRanges": [ # The ranges that were cleared, in A1 notation. If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits. + "clearedRanges": [ # The ranges that were cleared, in A1 notation. If the requests are for an unbounded range or a range larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits. "A String", ], "spreadsheetId": "A String", # The spreadsheet the updates were applied to. @@ -210,7 +210,7 @@

Method Details

batchClearByDataFilter(spreadsheetId, body=None, x__xgafv=None) -
Clears one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.
+  
Clears one or more ranges of values from a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc.) are kept.
 
 Args:
   spreadsheetId: string, The ID of the spreadsheet to update. (required)
@@ -219,15 +219,15 @@ 

Method Details

{ # The request for clearing more than one range selected by a DataFilter in a spreadsheet. "dataFilters": [ # The DataFilters used to determine which ranges to clear. - { # Filter that describes what data should be selected or returned from a request. + { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -260,7 +260,7 @@

Method Details

An object of the form: { # The response when clearing a range of values selected with DataFilters in a spreadsheet. - "clearedRanges": [ # The ranges that were cleared, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits. + "clearedRanges": [ # The ranges that were cleared, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a range larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits. "A String", ], "spreadsheetId": "A String", # The spreadsheet the updates were applied to. @@ -314,7 +314,7 @@

Method Details

batchGetByDataFilter(spreadsheetId, body=None, x__xgafv=None) -
Returns one or more ranges of values that match the specified data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.
+  
Returns one or more ranges of values that match the specified data filters. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.
 
 Args:
   spreadsheetId: string, The ID of the spreadsheet to retrieve data from. (required)
@@ -323,15 +323,15 @@ 

Method Details

{ # The request for retrieving a range of values in a spreadsheet selected by a set of DataFilters. "dataFilters": [ # The data filters used to match the ranges of values to retrieve. Ranges that match any of the specified data filters are included in the response. - { # Filter that describes what data should be selected or returned from a request. + { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -371,15 +371,15 @@

Method Details

"valueRanges": [ # The requested values with the list of data filters that matched them. { # A value range that was matched by one or more data filers. "dataFilters": [ # The DataFilters from the request that matched the range of values. - { # Filter that describes what data should be selected or returned from a request. + { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -479,7 +479,7 @@

Method Details

batchUpdateByDataFilter(spreadsheetId, body=None, x__xgafv=None) -
Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.
+  
Sets values in one or more ranges of a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.
 
 Args:
   spreadsheetId: string, The ID of the spreadsheet to update. (required)
@@ -489,15 +489,15 @@ 

Method Details

{ # The request for updating more than one range of values in a spreadsheet. "data": [ # The new values to apply to the spreadsheet. If more than one range is matched by the specified DataFilter the specified values are applied to all of those ranges. { # A range of values whose location is specified by a DataFilter. - "dataFilter": { # Filter that describes what data should be selected or returned from a request. # The data filter describing the location of the values in the spreadsheet. + "dataFilter": { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). # The data filter describing the location of the values in the spreadsheet. "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -543,15 +543,15 @@

Method Details

{ # The response when updating a range of values in a spreadsheet. "responses": [ # The response for each range updated. { # The response when updating a range of values by a data filter in a spreadsheet. - "dataFilter": { # Filter that describes what data should be selected or returned from a request. # The data filter that selected the range that was updated. + "dataFilter": { # Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). # The data filter that selected the range that was updated. "a1Range": "A String", # Selects data that matches the specified A1 range. - "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. + "developerMetadataLookup": { # Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified. # Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. "locationMatchingStrategy": "A String", # Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this field is specified, a metadataLocation must also be specified. - "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. + "locationType": "A String", # Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT. "metadataId": 42, # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. "metadataKey": "A String", # Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. "metadataLocation": { # A location where metadata may be associated in a spreadsheet. # Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the specified locationMatchingStrategy. - "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns. + "dimensionRange": { # A range along a single dimension on a sheet. All indexes are zero-based. Indexes are half open: the start index is inclusive and the end index is exclusive. Missing indexes indicate the range is unbounded on that side. # Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns. "dimension": "A String", # The dimension of the span. "endIndex": 42, # The end (exclusive) of the span, or not set if unbounded. "sheetId": 42, # The sheet this span is on. @@ -617,7 +617,7 @@

Method Details

An object of the form: { # The response when clearing a range of values in a spreadsheet. - "clearedRange": "A String", # The range (in A1 notation) that was cleared. (If the request was for an unbounded range or a ranger larger than the bounds of the sheet, this will be the actual range that was cleared, bounded to the sheet's limits.) + "clearedRange": "A String", # The range (in A1 notation) that was cleared. (If the request was for an unbounded range or a range larger than the bounds of the sheet, this will be the actual range that was cleared, bounded to the sheet's limits.) "spreadsheetId": "A String", # The spreadsheet the updates were applied to. }
diff --git a/docs/dyn/walletobjects_v1.jwt.html b/docs/dyn/walletobjects_v1.jwt.html index e03fe88bd93..57694aa8d52 100644 --- a/docs/dyn/walletobjects_v1.jwt.html +++ b/docs/dyn/walletobjects_v1.jwt.html @@ -94,8 +94,8 @@

Method Details

body: object, The request body. The object takes the form of: -{ - "jwt": "A String", # A string representing a JWT of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt +{ # A JWT representation of a pass. + "jwt": "A String", # Required. A string representing a JWT of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt } x__xgafv: string, V1 error format. diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1.json b/googleapiclient/discovery_cache/documents/alloydb.v1.json index 82cdb669857..233bc3dd785 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1.json @@ -1879,7 +1879,7 @@ } } }, -"revision": "20260205", +"revision": "20260213", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -3399,7 +3399,7 @@ false "id": "InstanceNetworkConfig", "properties": { "allocatedIpRangeOverride": { -"description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", +"description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", "type": "string" }, "authorizedExternalNetworks": { diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json b/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json index 56b0b44b950..11fdfdd9148 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json @@ -1879,7 +1879,7 @@ } } }, -"revision": "20260205", +"revision": "20260213", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -3519,7 +3519,7 @@ false "id": "InstanceNetworkConfig", "properties": { "allocatedIpRangeOverride": { -"description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", +"description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", "type": "string" }, "authorizedExternalNetworks": { diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1beta.json b/googleapiclient/discovery_cache/documents/alloydb.v1beta.json index 2678f0c7fae..4313d5724b4 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1beta.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1beta.json @@ -1876,7 +1876,7 @@ } } }, -"revision": "20260205", +"revision": "20260213", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -3495,7 +3495,7 @@ false "id": "InstanceNetworkConfig", "properties": { "allocatedIpRangeOverride": { -"description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", +"description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", "type": "string" }, "authorizedExternalNetworks": { diff --git a/googleapiclient/discovery_cache/documents/androidmanagement.v1.json b/googleapiclient/discovery_cache/documents/androidmanagement.v1.json index 391f658fcba..57d66c6f651 100644 --- a/googleapiclient/discovery_cache/documents/androidmanagement.v1.json +++ b/googleapiclient/discovery_cache/documents/androidmanagement.v1.json @@ -1265,7 +1265,7 @@ } } }, -"revision": "20260212", +"revision": "20260219", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { @@ -4276,7 +4276,7 @@ false "id": "GoogleAuthenticationSettings", "properties": { "googleAuthenticationRequired": { -"description": "Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url.", +"description": "Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set.", "enum": [ "GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED", "NOT_REQUIRED", diff --git a/googleapiclient/discovery_cache/documents/apphub.v1.json b/googleapiclient/discovery_cache/documents/apphub.v1.json index 50f070ac571..76d82d5a0f9 100644 --- a/googleapiclient/discovery_cache/documents/apphub.v1.json +++ b/googleapiclient/discovery_cache/documents/apphub.v1.json @@ -188,7 +188,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "apphub.projects.locations.list", @@ -1486,7 +1486,7 @@ } } }, -"revision": "20260119", +"revision": "20260204", "rootUrl": "https://apphub.googleapis.com/", "schemas": { "Application": { diff --git a/googleapiclient/discovery_cache/documents/apphub.v1alpha.json b/googleapiclient/discovery_cache/documents/apphub.v1alpha.json index 0d1a6696c03..3921280362e 100644 --- a/googleapiclient/discovery_cache/documents/apphub.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/apphub.v1alpha.json @@ -188,7 +188,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1alpha/projects/{projectsId}/locations", "httpMethod": "GET", "id": "apphub.projects.locations.list", @@ -1578,7 +1578,7 @@ } } }, -"revision": "20260119", +"revision": "20260204", "rootUrl": "https://apphub.googleapis.com/", "schemas": { "Application": { diff --git a/googleapiclient/discovery_cache/documents/calendar.v3.json b/googleapiclient/discovery_cache/documents/calendar.v3.json index 43d8678b99a..3287fba78b7 100644 --- a/googleapiclient/discovery_cache/documents/calendar.v3.json +++ b/googleapiclient/discovery_cache/documents/calendar.v3.json @@ -1890,7 +1890,7 @@ } } }, -"revision": "20251207", +"revision": "20260215", "rootUrl": "https://www.googleapis.com/", "schemas": { "Acl": { @@ -2511,7 +2511,7 @@ }, "conferenceData": { "$ref": "ConferenceData", -"description": "The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests." +"description": "The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field." }, "created": { "description": "Creation time of the event (as a RFC3339 timestamp). Read-only.", diff --git a/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json b/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json index 9f35805ef2d..e41452ee7ca 100644 --- a/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json +++ b/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json @@ -783,7 +783,7 @@ } } }, -"revision": "20260205", +"revision": "20260212", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AbortFunctionUpgradeRequest": { @@ -2275,6 +2275,22 @@ "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL", "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" ], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +true, +false +], "enumDescriptions": [ "Unspecified state. Most functions are in this upgrade state.", "Functions in this state are eligible for 1st Gen upgrade.", @@ -2288,7 +2304,7 @@ "RollbackFunctionUpgradeTraffic API was un-successful.", "CommitFunctionUpgrade API was un-successful and 1st gen function might have broken.", "CommitFunctionUpgrade API was un-successful but safe to rollback traffic or abort.", -"Indicates that the `CommitFunctionUpgradeAsGen2` API call succeeded and the function was successfully migrated to the 2nd Gen stack.", +"Deprecated: This state is no longer returned by the backend. Clients should not rely on polling for this specific state. A successful upgrade is now indicated by the long-running operation completing successfully with a Function resource in the response.", "CommitFunctionUpgradeAsGen2 API was un-successful and 1st gen function might have broken." ], "type": "string" diff --git a/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json b/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json index 3838c0fd993..3e41c68daaa 100644 --- a/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json +++ b/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json @@ -783,7 +783,7 @@ } } }, -"revision": "20260129", +"revision": "20260212", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AbortFunctionUpgradeRequest": { @@ -2275,6 +2275,22 @@ "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL", "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" ], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +true, +false +], "enumDescriptions": [ "Unspecified state. Most functions are in this upgrade state.", "Functions in this state are eligible for 1st Gen upgrade.", @@ -2288,7 +2304,7 @@ "RollbackFunctionUpgradeTraffic API was un-successful.", "CommitFunctionUpgrade API was un-successful and 1st gen function might have broken.", "CommitFunctionUpgrade API was un-successful but safe to rollback traffic or abort.", -"Indicates that the `CommitFunctionUpgradeAsGen2` API call succeeded and the function was successfully migrated to the 2nd Gen stack.", +"Deprecated: This state is no longer returned by the backend. Clients should not rely on polling for this specific state. A successful upgrade is now indicated by the long-running operation completing successfully with a Function resource in the response.", "CommitFunctionUpgradeAsGen2 API was un-successful and 1st gen function might have broken." ], "type": "string" diff --git a/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json b/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json index 1bbd44b5fe6..bc06f47806a 100644 --- a/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json +++ b/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json @@ -783,7 +783,7 @@ } } }, -"revision": "20260129", +"revision": "20260212", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AbortFunctionUpgradeRequest": { @@ -2275,6 +2275,22 @@ "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL", "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" ], +"enumDeprecated": [ +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +false, +true, +false +], "enumDescriptions": [ "Unspecified state. Most functions are in this upgrade state.", "Functions in this state are eligible for 1st Gen upgrade.", @@ -2288,7 +2304,7 @@ "RollbackFunctionUpgradeTraffic API was un-successful.", "CommitFunctionUpgrade API was un-successful and 1st gen function might have broken.", "CommitFunctionUpgrade API was un-successful but safe to rollback traffic or abort.", -"Indicates that the `CommitFunctionUpgradeAsGen2` API call succeeded and the function was successfully migrated to the 2nd Gen stack.", +"Deprecated: This state is no longer returned by the backend. Clients should not rely on polling for this specific state. A successful upgrade is now indicated by the long-running operation completing successfully with a Function resource in the response.", "CommitFunctionUpgradeAsGen2 API was un-successful and 1st gen function might have broken." ], "type": "string" diff --git a/googleapiclient/discovery_cache/documents/cloudscheduler.v1.json b/googleapiclient/discovery_cache/documents/cloudscheduler.v1.json index dcb9976aaed..b9672001397 100644 --- a/googleapiclient/discovery_cache/documents/cloudscheduler.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudscheduler.v1.json @@ -160,7 +160,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "cloudscheduler.projects.locations.list", @@ -611,7 +611,7 @@ } } }, -"revision": "20251205", +"revision": "20260202", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/googleapiclient/discovery_cache/documents/cloudscheduler.v1beta1.json b/googleapiclient/discovery_cache/documents/cloudscheduler.v1beta1.json index c0ce4e1dfd0..fb81baed5d0 100644 --- a/googleapiclient/discovery_cache/documents/cloudscheduler.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/cloudscheduler.v1beta1.json @@ -135,7 +135,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1beta1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "cloudscheduler.projects.locations.list", @@ -567,7 +567,7 @@ } } }, -"revision": "20251205", +"revision": "20260202", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json index 2c9b4fc8cd2..6d74d5d1bdd 100644 --- a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json +++ b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json @@ -3555,7 +3555,7 @@ "type": "string" }, "updateMask": { -"description": "Optional. List of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `display_name` * `root_container`", +"description": "Optional. List of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `display_name` * `root_container` * `description`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -6101,7 +6101,7 @@ } } }, -"revision": "20260202", +"revision": "20260219", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { diff --git a/googleapiclient/discovery_cache/documents/dataform.v1.json b/googleapiclient/discovery_cache/documents/dataform.v1.json index e3cf635ec47..10743b2c899 100644 --- a/googleapiclient/discovery_cache/documents/dataform.v1.json +++ b/googleapiclient/discovery_cache/documents/dataform.v1.json @@ -164,7 +164,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "dataform.projects.locations.list", @@ -2467,7 +2467,7 @@ } } }, -"revision": "20251202", +"revision": "20260217", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -4156,7 +4156,7 @@ "type": "array" }, "connection": { -"description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}\", or be set to DEFAULT.", +"description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}`, or be set to DEFAULT.", "type": "string" }, "dependencyTargets": { diff --git a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json index 2cb9a1858fa..31cc937541e 100644 --- a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json @@ -164,7 +164,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1beta1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "dataform.projects.locations.list", @@ -2955,7 +2955,7 @@ } } }, -"revision": "20260106", +"revision": "20260217", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -4322,7 +4322,7 @@ "id": "MoveFolderRequest", "properties": { "destinationContainingFolder": { -"description": "Required. The name of the Folder, TeamFolder, or root location to move the Folder to. Can be in the format of: - \"\" to move into the root User folder - `projects/*/locations/*/folders/*` - `projects/*/locations/*/teamFolders/*`", +"description": "Optional. The name of the Folder, TeamFolder, or root location to move the Folder to. Can be in the format of: \"\" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*`", "type": "string" } }, @@ -4333,7 +4333,7 @@ "id": "MoveRepositoryRequest", "properties": { "destinationContainingFolder": { -"description": "Required. The name of the Folder, TeamFolder, or root location to move the repository to. Can be in the format of: - \"\" to move into the root User folder - `projects/*/locations/*/folders/*` - `projects/*/locations/*/teamFolders/*`", +"description": "Optional. The name of the Folder, TeamFolder, or root location to move the repository to. Can be in the format of: \"\" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*`", "type": "string" } }, @@ -4781,7 +4781,7 @@ "type": "array" }, "connection": { -"description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}\", or be set to DEFAULT.", +"description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}`, or be set to DEFAULT.", "type": "string" }, "dependencyTargets": { diff --git a/googleapiclient/discovery_cache/documents/documentai.v1.json b/googleapiclient/discovery_cache/documents/documentai.v1.json index b78f08436bb..35804828fa4 100644 --- a/googleapiclient/discovery_cache/documents/documentai.v1.json +++ b/googleapiclient/discovery_cache/documents/documentai.v1.json @@ -1431,7 +1431,7 @@ } } }, -"revision": "20260203", +"revision": "20260217", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": { @@ -2163,12 +2163,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", -"DERIVE" +"DERIVE", +"RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", -"The entity's value is derived through inference and is not necessarily an exact text extraction from the document." +"The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", +"Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -3195,12 +3197,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", -"DERIVE" +"DERIVE", +"RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", -"The entity's value is derived through inference and is not necessarily an exact text extraction from the document." +"The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", +"Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -5304,12 +5308,14 @@ true "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", -"DERIVE" +"DERIVE", +"RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", -"The entity's value is derived through inference and is not necessarily an exact text extraction from the document." +"The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", +"Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -7561,12 +7567,14 @@ true "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", -"DERIVE" +"DERIVE", +"RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", -"The entity's value is derived through inference and is not necessarily an exact text extraction from the document." +"The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", +"Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/documentai.v1beta3.json b/googleapiclient/discovery_cache/documents/documentai.v1beta3.json index 665e1ebfc56..e5622829751 100644 --- a/googleapiclient/discovery_cache/documents/documentai.v1beta3.json +++ b/googleapiclient/discovery_cache/documents/documentai.v1beta3.json @@ -1673,7 +1673,7 @@ } } }, -"revision": "20260203", +"revision": "20260217", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": { @@ -2405,12 +2405,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", -"DERIVE" +"DERIVE", +"RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", -"The entity's value is derived through inference and is not necessarily an exact text extraction from the document." +"The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", +"Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -3437,12 +3439,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", -"DERIVE" +"DERIVE", +"RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", -"The entity's value is derived through inference and is not necessarily an exact text extraction from the document." +"The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", +"Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -6426,12 +6430,14 @@ true "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", -"DERIVE" +"DERIVE", +"RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", -"The entity's value is derived through inference and is not necessarily an exact text extraction from the document." +"The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", +"Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/iam.v1.json b/googleapiclient/discovery_cache/documents/iam.v1.json index e898677cb4f..c53c91de91e 100644 --- a/googleapiclient/discovery_cache/documents/iam.v1.json +++ b/googleapiclient/discovery_cache/documents/iam.v1.json @@ -4160,7 +4160,7 @@ } } }, -"revision": "20260206", +"revision": "20260213", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AccessRestrictions": { @@ -6557,12 +6557,14 @@ false "enum": [ "MODE_UNSPECIFIED", "FEDERATION_ONLY", -"TRUST_DOMAIN" +"TRUST_DOMAIN", +"SYSTEM_TRUST_DOMAIN" ], "enumDescriptions": [ "State unspecified. New pools should not use this mode. Pools with an unspecified mode will operate as if they are in federation-only mode.", -"Federation-only mode. Federation-only pools can only be used for federating external workload identities into Google Cloud. Unless otherwise noted, no structure or format constraints are applied to workload identities in a federation-only pool, and you cannot create any resources within the pool besides providers.", -"Trust-domain mode. Trust-domain pools can be used to assign identities to Google Cloud workloads. All identities within a trust-domain pool must consist of a single namespace and individual workload identifier. The subject identifier for all identities must conform to the following format: `ns//sa/` WorkloadIdentityPoolProviders cannot be created within trust-domain pools." +"Federation-only mode. FEDERATION_ONLY mode pools can only be used for federating external workload identities into Google Cloud. Unless otherwise noted, no structure or format constraints are applied to workload identities in a FEDERATION_ONLY mode pool, and you cannot create any resources within the pool besides providers.", +"Trust-domain mode. TRUST_DOMAIN mode pools can be used to assign identities to Google Cloud workloads. Identities within a TRUST_DOMAIN mode pool share the same root of trust. WorkloadIdentityPoolProviders cannot be created within trust-domain pools.", +"SYSTEM_TRUST_DOMAIN mode pools are managed by Google Cloud services. Neither WorkloadIdentityPoolNamespaces nor WorkloadIdentityPoolProviders can be created within SYSTEM_TRUST_DOMAIN mode pools. All identities within a SYSTEM_TRUST_DOMAIN mode pool are in one of the following formats: * `spiffe:///ns//sa/` * `spiffe:///resources//`" ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/kmsinventory.v1.json b/googleapiclient/discovery_cache/documents/kmsinventory.v1.json index 904c324ff7a..b261addff9d 100644 --- a/googleapiclient/discovery_cache/documents/kmsinventory.v1.json +++ b/googleapiclient/discovery_cache/documents/kmsinventory.v1.json @@ -141,7 +141,7 @@ "type": "string" }, "scope": { -"description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The allowed values are: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", +"description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The following values are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -286,7 +286,7 @@ "type": "string" }, "scope": { -"description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The allowed values are: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", +"description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The following values are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -306,7 +306,7 @@ } } }, -"revision": "20260201", +"revision": "20260216", "rootUrl": "https://kmsinventory.googleapis.com/", "schemas": { "GoogleCloudKmsInventoryV1ListCryptoKeysResponse": { @@ -453,7 +453,7 @@ "type": "object" }, "GoogleCloudKmsInventoryV1Warning": { -"description": "Warning message specifying various states of response data that might indicate incomplete or partial results.", +"description": "A warning message that indicates potential problems with the response data.", "id": "GoogleCloudKmsInventoryV1Warning", "properties": { "displayMessage": { @@ -470,9 +470,9 @@ ], "enumDescriptions": [ "Default value. This value is unused.", -"Indicates that the caller or service agent lacks necessary permissions to view some of the requested data. The response may be partial. Examples: - KMS organization service agent {service_agent_name} lacks the `cloudasset.assets.searchAllResources` permission on the scope.", -"Indicates that a resource limit has been exceeded, resulting in partial data. Examples: - The project has more than 10,000 assets (resources, crypto keys, key handles, IAM policies, etc).", -"Indicates that the project is org-less. Thus the analysis is only done for the project level data and results might be partial." +"Indicates that the caller or service agent lacks necessary permissions to view some of the requested data. The response may be partial. Example: - KMS organization service agent {service_agent_name} lacks the `cloudasset.assets.searchAllResources` permission on the scope.", +"Indicates that a resource limit has been exceeded, resulting in partial data. Example: - The project has more than 10,000 assets (resources, crypto keys, key handles, IAM policies, etc).", +"Indicates that the project exists outside of an organization resource. Thus the analysis is only done for the project level data and results might be partial." ], "type": "string" } diff --git a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json index 36ce7a37424..8bb17b08858 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1.json @@ -2410,7 +2410,7 @@ } } }, -"revision": "20260206", +"revision": "20260218", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "About": { @@ -2484,7 +2484,7 @@ "type": "string" }, "accountName": { -"description": "Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.", +"description": "Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the \"/\" or \"_\" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information.", "type": "string" }, "adultContent": { @@ -3123,7 +3123,7 @@ "readOnly": true }, "eligibleDestinations": { -"description": "Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`", +"description": "Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`.", "items": { "enum": [ "DESTINATION_ENUM_UNSPECIFIED", @@ -4871,7 +4871,7 @@ false "type": "object" }, "Program": { -"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`", +"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout`", "id": "Program", "properties": { "activeRegionCodes": { diff --git a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json index 086776dc7af..92eccb2f03a 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json @@ -2360,7 +2360,7 @@ } } }, -"revision": "20260206", +"revision": "20260218", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "About": { @@ -2434,7 +2434,7 @@ "type": "string" }, "accountName": { -"description": "Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.", +"description": "Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the \"/\" or \"_\" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information.", "type": "string" }, "adultContent": { @@ -3003,7 +3003,7 @@ "readOnly": true }, "eligibleDestinations": { -"description": "Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`", +"description": "Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`.", "items": { "enum": [ "DESTINATION_ENUM_UNSPECIFIED", @@ -4748,7 +4748,7 @@ false "type": "object" }, "Program": { -"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`", +"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout`", "id": "Program", "properties": { "activeRegionCodes": { diff --git a/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json index 6a2ae21ce0f..14587443f89 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.ordertracking_v1.json @@ -147,7 +147,7 @@ } } }, -"revision": "20250805", +"revision": "20260221", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "DateTime": { @@ -344,6 +344,7 @@ "LOCAL_INVENTORY_ADS", "VEHICLE_INVENTORY_ADS", "FREE_LISTINGS", +"FREE_LISTINGS_UCP_CHECKOUT", "FREE_LOCAL_LISTINGS", "FREE_LOCAL_VEHICLE_LISTINGS", "YOUTUBE_AFFILIATE", @@ -373,6 +374,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -386,6 +388,7 @@ false "[Local inventory ads](https://support.google.com/merchants/answer/3271956).", "[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).", "[Free product listings](https://support.google.com/merchants/answer/9199328).", +"[Free product listings on UCP checkout](https://developers.google.com/merchant/ucp).", "[Free local product listings](https://support.google.com/merchants/answer/9825611).", "[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).", "[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).", diff --git a/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json b/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json index 1aabd9206f0..cff916a7093 100644 --- a/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json @@ -1804,7 +1804,7 @@ } } }, -"revision": "20260128", +"revision": "20260214", "rootUrl": "https://saasservicemgmt.googleapis.com/", "schemas": { "Aggregate": { @@ -3059,7 +3059,7 @@ "type": "object" }, "UnitOperation": { -"description": "UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19", +"description": "UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22", "id": "UnitOperation", "properties": { "annotations": { @@ -3237,14 +3237,18 @@ "TYPE_SCHEDULED", "TYPE_RUNNING", "TYPE_SUCCEEDED", -"TYPE_CANCELLED" +"TYPE_CANCELLED", +"TYPE_APP_CREATED", +"TYPE_APP_COMPONENTS_REGISTERED" ], "enumDescriptions": [ "Condition type is unspecified.", "Condition type is scheduled.", "Condition type is running.", "Condition type is succeeded.", -"Condition type is cancelled." +"Condition type is cancelled.", +"Indicates if AppHub app has been created.", +"Indicates if services and workloads have been registered with AppHub." ], "type": "string" } diff --git a/googleapiclient/discovery_cache/documents/servicedirectory.v1.json b/googleapiclient/discovery_cache/documents/servicedirectory.v1.json index 025ecc77ef5..ed9ffe7c933 100644 --- a/googleapiclient/discovery_cache/documents/servicedirectory.v1.json +++ b/googleapiclient/discovery_cache/documents/servicedirectory.v1.json @@ -135,7 +135,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "servicedirectory.projects.locations.list", @@ -889,7 +889,7 @@ } } }, -"revision": "20251030", +"revision": "20260217", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { diff --git a/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json b/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json index 2542dfd4a38..88041d7dd2c 100644 --- a/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/servicedirectory.v1beta1.json @@ -135,7 +135,7 @@ ] }, "list": { -"description": "Lists information about the supported locations for this service.", +"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1beta1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "servicedirectory.projects.locations.list", @@ -977,7 +977,7 @@ } } }, -"revision": "20251030", +"revision": "20260217", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { diff --git a/googleapiclient/discovery_cache/documents/sheets.v4.json b/googleapiclient/discovery_cache/documents/sheets.v4.json index 60e558a924d..a8c65de9b82 100644 --- a/googleapiclient/discovery_cache/documents/sheets.v4.json +++ b/googleapiclient/discovery_cache/documents/sheets.v4.json @@ -213,7 +213,7 @@ ] }, "getByDataFilter": { -"description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.", +"description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data in one of two ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP. * Set the includeGridData parameter to `true`. If a field mask is set, the `includeGridData` parameter is ignored. For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.", "flatPath": "v4/spreadsheets/{spreadsheetId}:getByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.getByDataFilter", @@ -246,7 +246,7 @@ "developerMetadata": { "methods": { "get": { -"description": "Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId.", +"description": "Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata).", "flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}", "httpMethod": "GET", "id": "sheets.spreadsheets.developerMetadata.get", @@ -280,7 +280,7 @@ ] }, "search": { -"description": "Returns all developer metadata matching the specified DataFilter. If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.", +"description": "Returns all developer metadata matching the specified DataFilter. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.", "flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata:search", "httpMethod": "POST", "id": "sheets.spreadsheets.developerMetadata.search", @@ -480,7 +480,7 @@ ] }, "batchClearByDataFilter": { -"description": "Clears one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.", +"description": "Clears one or more ranges of values from a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc.) are kept.", "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.values.batchClearByDataFilter", @@ -586,7 +586,7 @@ ] }, "batchGetByDataFilter": { -"description": "Returns one or more ranges of values that match the specified data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.", +"description": "Returns one or more ranges of values that match the specified data filters. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.", "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.values.batchGetByDataFilter", @@ -644,7 +644,7 @@ ] }, "batchUpdateByDataFilter": { -"description": "Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.", +"description": "Sets values in one or more ranges of a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.", "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.values.batchUpdateByDataFilter", @@ -875,7 +875,7 @@ } } }, -"revision": "20251110", +"revision": "20260213", "rootUrl": "https://sheets.googleapis.com/", "schemas": { "AddBandingRequest": { @@ -995,7 +995,7 @@ "properties": { "filter": { "$ref": "FilterView", -"description": "The filter to add. The filterViewId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a filter that already exists.)" +"description": "The filter to add. The filterViewId field is optional. If one is not set, an ID will be randomly generated. (It is an error to specify the ID of a filter that already exists.)" } }, "type": "object" @@ -1614,7 +1614,7 @@ "type": "object" }, "BasicFilter": { -"description": "The default filter associated with a sheet.", +"description": "The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters).", "id": "BasicFilter", "properties": { "criteria": { @@ -1694,7 +1694,7 @@ "id": "BatchClearValuesByDataFilterResponse", "properties": { "clearedRanges": { -"description": "The ranges that were cleared, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", +"description": "The ranges that were cleared, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a range larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", "items": { "type": "string" }, @@ -1726,7 +1726,7 @@ "id": "BatchClearValuesResponse", "properties": { "clearedRanges": { -"description": "The ranges that were cleared, in A1 notation. If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", +"description": "The ranges that were cleared, in A1 notation. If the requests are for an unbounded range or a range larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", "items": { "type": "string" }, @@ -3030,7 +3030,7 @@ "id": "ClearValuesResponse", "properties": { "clearedRange": { -"description": "The range (in A1 notation) that was cleared. (If the request was for an unbounded range or a ranger larger than the bounds of the sheet, this will be the actual range that was cleared, bounded to the sheet's limits.)", +"description": "The range (in A1 notation) that was cleared. (If the request was for an unbounded range or a range larger than the bounds of the sheet, this will be the actual range that was cleared, bounded to the sheet's limits.)", "type": "string" }, "spreadsheetId": { @@ -3365,7 +3365,7 @@ "type": "object" }, "DataFilter": { -"description": "Filter that describes what data should be selected or returned from a request.", +"description": "Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata).", "id": "DataFilter", "properties": { "a1Range": { @@ -4156,7 +4156,7 @@ "type": "object" }, "DeveloperMetadata": { -"description": "Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too.", +"description": "Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too.", "id": "DeveloperMetadata", "properties": { "location": { @@ -4177,7 +4177,7 @@ "type": "string" }, "visibility": { -"description": "The metadata visibility. Developer metadata must always have a visibility specified.", +"description": "The metadata visibility. Developer metadata must always have visibility specified.", "enum": [ "DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED", "DOCUMENT", @@ -4199,7 +4199,7 @@ "properties": { "dimensionRange": { "$ref": "DimensionRange", -"description": "Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns." +"description": "Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns." }, "locationType": { "description": "The type of location this object represents. This field is read-only.", @@ -4232,7 +4232,7 @@ "type": "object" }, "DeveloperMetadataLookup": { -"description": "Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified.", +"description": "Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified.", "id": "DeveloperMetadataLookup", "properties": { "locationMatchingStrategy": { @@ -4250,7 +4250,7 @@ "type": "string" }, "locationType": { -"description": "Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT.", +"description": "Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT.", "enum": [ "DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED", "ROW", @@ -4602,12 +4602,12 @@ "type": "object" }, "FilterCriteria": { -"description": "Criteria for showing/hiding rows in a filter or filter view.", +"description": "Criteria for showing or hiding rows in a filter or filter view.", "id": "FilterCriteria", "properties": { "condition": { "$ref": "BooleanCondition", -"description": "A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.)" +"description": "A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.)" }, "hiddenValues": { "description": "Values that should be hidden.", @@ -4658,7 +4658,7 @@ "type": "object" }, "FilterView": { -"description": "A filter view.", +"description": "A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters).", "id": "FilterView", "properties": { "criteria": { @@ -4670,7 +4670,7 @@ "type": "object" }, "filterSpecs": { -"description": "The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence.", +"description": "The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence.", "items": { "$ref": "FilterSpec" }, @@ -4682,12 +4682,12 @@ "type": "integer" }, "namedRangeId": { -"description": "The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set.", +"description": "The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set.", "type": "string" }, "range": { "$ref": "GridRange", -"description": "The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set." +"description": "The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set." }, "sortSpecs": { "description": "The sort order per column. Later specifications are used when values are equal in the earlier specifications.", @@ -4697,7 +4697,7 @@ "type": "array" }, "tableId": { -"description": "The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set.", +"description": "The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set.", "type": "string" }, "title": { diff --git a/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json b/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json index 3a690400586..c3a81cdf208 100644 --- a/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json +++ b/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json @@ -2548,7 +2548,7 @@ } } }, -"revision": "20260129", +"revision": "20260222", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AccessKeyCredentials": { @@ -3311,14 +3311,16 @@ "COMPUTE_ENGINE_DISK_TYPE_STANDARD", "COMPUTE_ENGINE_DISK_TYPE_SSD", "COMPUTE_ENGINE_DISK_TYPE_BALANCED", -"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED", +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED_HIGH_AVAILABILITY" ], "enumDescriptions": [ "An unspecified disk type. Will be used as STANDARD.", "A Standard disk type.", "SSD hard disk type.", "An alternative to SSD persistent disks that balance performance and cost.", -"Hyperdisk balanced disk type." +"Hyperdisk balanced disk type.", +"Hyperdisk balanced high availability disk type." ], "type": "string" }, @@ -3516,14 +3518,16 @@ "COMPUTE_ENGINE_DISK_TYPE_STANDARD", "COMPUTE_ENGINE_DISK_TYPE_SSD", "COMPUTE_ENGINE_DISK_TYPE_BALANCED", -"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED", +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED_HIGH_AVAILABILITY" ], "enumDescriptions": [ "An unspecified disk type. Will be used as STANDARD.", "A Standard disk type.", "SSD hard disk type.", "An alternative to SSD persistent disks that balance performance and cost.", -"Hyperdisk balanced disk type." +"Hyperdisk balanced disk type.", +"Hyperdisk balanced high availability disk type." ], "type": "string" }, @@ -3663,14 +3667,16 @@ "COMPUTE_ENGINE_DISK_TYPE_STANDARD", "COMPUTE_ENGINE_DISK_TYPE_SSD", "COMPUTE_ENGINE_DISK_TYPE_BALANCED", -"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED", +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED_HIGH_AVAILABILITY" ], "enumDescriptions": [ "An unspecified disk type. Will be used as STANDARD.", "A Standard disk type.", "SSD hard disk type.", "An alternative to SSD persistent disks that balance performance and cost.", -"Hyperdisk balanced disk type." +"Hyperdisk balanced disk type.", +"Hyperdisk balanced high availability disk type." ], "type": "string" }, @@ -3835,14 +3841,16 @@ "COMPUTE_ENGINE_DISK_TYPE_STANDARD", "COMPUTE_ENGINE_DISK_TYPE_SSD", "COMPUTE_ENGINE_DISK_TYPE_BALANCED", -"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED", +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED_HIGH_AVAILABILITY" ], "enumDescriptions": [ "An unspecified disk type. Will be used as STANDARD.", "A Standard disk type.", "SSD hard disk type.", "An alternative to SSD persistent disks that balance performance and cost.", -"Hyperdisk balanced disk type." +"Hyperdisk balanced disk type.", +"Hyperdisk balanced high availability disk type." ], "type": "string" }, @@ -6030,14 +6038,16 @@ "COMPUTE_ENGINE_DISK_TYPE_STANDARD", "COMPUTE_ENGINE_DISK_TYPE_SSD", "COMPUTE_ENGINE_DISK_TYPE_BALANCED", -"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED", +"COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED_HIGH_AVAILABILITY" ], "enumDescriptions": [ "An unspecified disk type. Will be used as STANDARD.", "A Standard disk type.", "SSD hard disk type.", "An alternative to SSD persistent disks that balance performance and cost.", -"Hyperdisk balanced disk type." +"Hyperdisk balanced disk type.", +"Hyperdisk balanced high availability disk type." ], "type": "string" }, @@ -6509,14 +6519,16 @@ "STANDARD", "BALANCED", "SSD", -"HYPERDISK_BALANCED" +"HYPERDISK_BALANCED", +"HYPERDISK_BALANCED_HIGH_AVAILABILITY" ], "enumDescriptions": [ "An unspecified disk type. Will be used as STANDARD.", "A Standard disk type.", "An alternative to SSD persistent disks that balance performance and cost.", "SSD hard disk type.", -"Hyperdisk balanced disk type." +"Hyperdisk balanced disk type.", +"Hyperdisk balanced high availability disk type." ], "type": "string" }, diff --git a/googleapiclient/discovery_cache/documents/walletobjects.v1.json b/googleapiclient/discovery_cache/documents/walletobjects.v1.json index 02614d6129b..c278cd3ae88 100644 --- a/googleapiclient/discovery_cache/documents/walletobjects.v1.json +++ b/googleapiclient/discovery_cache/documents/walletobjects.v1.json @@ -2713,7 +2713,7 @@ } } }, -"revision": "20260213", +"revision": "20260220", "rootUrl": "https://walletobjects.googleapis.com/", "schemas": { "ActivationOptions": { @@ -6405,10 +6405,11 @@ true "type": "object" }, "JwtResource": { +"description": "A JWT representation of a pass.", "id": "JwtResource", "properties": { "jwt": { -"description": "A string representing a JWT of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt", +"description": "Required. A string representing a JWT of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt", "type": "string" } },